aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorng0 <ng0@n0.is>2019-04-01 14:17:23 +0000
committerng0 <ng0@n0.is>2019-04-01 14:17:23 +0000
commitdcdd00d1378ca65397486c1f9653321f8daac268 (patch)
tree622724da9285d1f30b7c00edc63afb52fe3924bf
parent1238b1f27382971a5ad0ad07ea0ed30b6d3aad17 (diff)
downloadgnunet-dcdd00d1378ca65397486c1f9653321f8daac268.tar.gz
gnunet-dcdd00d1378ca65397486c1f9653321f8daac268.zip
handbook: fixes and comments in preface
-rw-r--r--doc/handbook/chapters/preface.texi23
1 files changed, 15 insertions, 8 deletions
diff --git a/doc/handbook/chapters/preface.texi b/doc/handbook/chapters/preface.texi
index 98ae6d4e5..636458eeb 100644
--- a/doc/handbook/chapters/preface.texi
+++ b/doc/handbook/chapters/preface.texi
@@ -1,10 +1,12 @@
1@node Preface 1@node Preface
2@chapter Preface 2@chapter Preface
3 3
4@c FIXME: Long sentence is long. 4@c FIXME: Do we have to mention that this is Free Software?
5This collection of manuals describes how to use GNUnet, a framework 5@c FIXME: where did 'Free Software' in this sentence fit before
6@c FIXME: we changed it?
7This collection of manuals describes GNUnet, a framework
6for secure peer-to-peer networking with the high-level goal to provide 8for secure peer-to-peer networking with the high-level goal to provide
7a strong foundation Free Software for a global, distributed network 9a strong foundation for a global, distributed network
8that provides security and privacy. 10that provides security and privacy.
9GNUnet in that sense aims to replace the current Internet protocol stack. 11GNUnet in that sense aims to replace the current Internet protocol stack.
10Along with an application for secure publication of files, it has grown to 12Along with an application for secure publication of files, it has grown to
@@ -24,7 +26,8 @@ Internet.
24 26
25The books (described as ``book'' or ``books'' in the following) 27The books (described as ``book'' or ``books'' in the following)
26bundled as the ``GNUnet Reference Manual'' are based on the historic 28bundled as the ``GNUnet Reference Manual'' are based on the historic
27work of all contributors to GNUnet's documentation. It is our hope 29work of all contributors to previous documentation of GNUnet.
30It is our hope
28that the content is described in a way that does not require any 31that the content is described in a way that does not require any
29academic background, although some concepts will require further 32academic background, although some concepts will require further
30reading. 33reading.
@@ -36,28 +39,32 @@ on a solution to describe the explanations found there which fits our
36use-case and licensing. 39use-case and licensing.
37 40
38Previously the documentation was contained in Drupal books, on the 41Previously the documentation was contained in Drupal books, on the
39old website. It was considered unmaintainable for the future, so 42old website. This format was considered unmaintainable for the future, so
40Texinfo was chosen. You might find old and very old sections in 43Texinfo was chosen. You might find old and very old sections in
41here in addition to more recent content. It took a long time to 44here in addition to more recent content. It took a long time to
42finish the move to Texinfo (from Drupal to LaTeX to wrong Texinfo 45finish the move to Texinfo (from Drupal to LaTeX to wrong Texinfo
43output dump to good Texinfo) and only recently (late 2018, early 46output dump to good Texinfo) and only recently (late 2018, early
442019 content checking started. We apologize to the reader for 472019) content checking started. We apologize to the reader for
45any inconvenience and hope you apply logic where bad advice from 48any inconvenience and hope you apply logic where bad advice from
4610 years ago can be found (pipe to sudo to install software is 4910 years ago can be found (pipe to sudo to install software is
47one example). 50one example). Patches (contributions) to this documentation are more
51than welcome!
48 52
49The first chapter (``Preface'') as well as the the second chapter 53The first chapter (``Preface'') as well as the the second chapter
50(``Philosophy'') give an introduction to GNUnet as a project, what 54(``Philosophy'') give an introduction to GNUnet as a project, what
51GNUnet tries to achieve. ``Key Concepts'' explains the key concepts 55GNUnet tries to achieve. ``Key Concepts'' explains the key concepts
52in GNUnet. 56in GNUnet.
53These three chapters are the most complete in the documentation. 57These three chapters are the most complete in the documentation.
54They are followed by chapters which need more work: 58They are followed by chapters which explain specific parts of
59GNUnet (and need more work):
55``Installing GNUnet'', ``GNUnet Contributors Handbook'' and 60``Installing GNUnet'', ``GNUnet Contributors Handbook'' and
56``GNUnet Developer Handbook''. 61``GNUnet Developer Handbook''.
57 62
58@node Contributing to this book 63@node Contributing to this book
59@section Contributing to this book 64@section Contributing to this book
60 65
66@c FIXME: There's a good amount of repetition here, we should
67@c FIXME: fix this.
61The GNUnet Reference Manual is a collective work produced by various 68The GNUnet Reference Manual is a collective work produced by various
62people throughout the years. 69people throughout the years.
63 70