summaryrefslogtreecommitdiff
path: root/doc/handbook
diff options
context:
space:
mode:
authorng0 <ng0@n0.is>2019-03-04 11:26:12 +0000
committerng0 <ng0@n0.is>2019-03-04 11:26:12 +0000
commit86b382be842b8b7f97a7a9f985a2116ad428d9c1 (patch)
tree9b4a7977270e45de7c75b36b642089b2beb05c19 /doc/handbook
parent2b3e187db8f97c4ec88bbdb157ac184b9cba5b46 (diff)
bump copyright year, extend "About this book" with a disclaimer
Diffstat (limited to 'doc/handbook')
-rw-r--r--doc/handbook/chapters/preface.texi33
-rw-r--r--doc/handbook/gnunet.texi2
2 files changed, 26 insertions, 9 deletions
diff --git a/doc/handbook/chapters/preface.texi b/doc/handbook/chapters/preface.texi
index 386cefa6d..4b6610d2c 100644
--- a/doc/handbook/chapters/preface.texi
+++ b/doc/handbook/chapters/preface.texi
@@ -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
diff --git a/doc/handbook/gnunet.texi b/doc/handbook/gnunet.texi
index bfcc580d9..a622c8f49 100644
--- a/doc/handbook/gnunet.texi
+++ b/doc/handbook/gnunet.texi
@@ -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