bump copyright year, extend "About this book" with a disclaimer
authorng0 <ng0@n0.is>
Mon, 4 Mar 2019 11:26:12 +0000 (11:26 +0000)
committerng0 <ng0@n0.is>
Mon, 4 Mar 2019 11:26:12 +0000 (11:26 +0000)
doc/handbook/chapters/preface.texi
doc/handbook/gnunet.texi

index 386cefa6d8fba5c1797983aee6c6fc8681276370..4b6610d2c66db0161eb995ccda7090176a64e7cb 100644 (file)
@@ -27,14 +27,31 @@ that the content is described in a way that does not require any
 academic background, although some concepts will require further
 reading.
 
-Our (long-term) goal with these books is to keep them self-contained. If
-you see references to Wikipedia and other external sources (except for
-our academic papers) it means that we are working on a solution to
-describe the explanations found there which fits our use-case and licensing.
-
-The first chapter (``Preface'') as well as the the second
-chapter (``Philosophy'') give an introduction to GNUnet as a project,
-what GNUnet tries to achieve.
+Our (long-term) goal with these books is to keep them
+self-contained. If you see references to Wikipedia and other external
+sources (except for our academic papers) it means that we are working
+on a solution to describe the explanations found there which fits our
+use-case and licensing.
+
+Previously the documentation was contained in Drupal books, on the
+old website. It was considered unmaintainable for the future, so
+Texinfo was chosen. You might find old and very old sections in
+here in addition to more recent content. It took a long time to
+finish the move to Texinfo (from Drupal to LaTeX to wrong Texinfo
+output dump to good Texinfo) and only recently (late 2018, early
+2019 content checking started. We apologize to the reader for
+any inconvenience and hope you apply logic where bad advice from
+10 years ago can be found (pipe to sudo to install software is
+one example).
+
+The first chapter (``Preface'') as well as the the second chapter
+(``Philosophy'') give an introduction to GNUnet as a project, what
+GNUnet tries to achieve. ``Key Concepts'' explains the key concepts
+in GNUnet.
+These three chapters are the most complete in the documentation.
+They are followed by chapters which need more work:
+``Installing GNUnet'', ``GNUnet Contributors Handbook'' and
+``GNUnet Developer Handbook''.
 
 @node Contributing to this book
 @section Contributing to this book
index bfcc580d98d24d82ee7bb92b61564d42af1c76bd..a622c8f491dfb9b1933a9b86c165eb2c1adabe65 100644 (file)
@@ -14,7 +14,7 @@
 @c @set OPENPGP-SIGNING-KEY-ID
 
 @copying
-Copyright @copyright{} 2001-2018 GNUnet e.V.
+Copyright @copyright{} 2001-2019 GNUnet e.V.
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or