diff options
Diffstat (limited to 'doc/handbook/chapters/preface.texi')
-rw-r--r-- | doc/handbook/chapters/preface.texi | 33 |
1 files changed, 25 insertions, 8 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 | |||
27 | academic background, although some concepts will require further | 27 | academic background, although some concepts will require further |
28 | reading. | 28 | reading. |
29 | 29 | ||
30 | Our (long-term) goal with these books is to keep them self-contained. If | 30 | Our (long-term) goal with these books is to keep them |
31 | you see references to Wikipedia and other external sources (except for | 31 | self-contained. If you see references to Wikipedia and other external |
32 | our academic papers) it means that we are working on a solution to | 32 | sources (except for our academic papers) it means that we are working |
33 | describe the explanations found there which fits our use-case and licensing. | 33 | on a solution to describe the explanations found there which fits our |
34 | 34 | use-case and licensing. | |
35 | The first chapter (``Preface'') as well as the the second | 35 | |
36 | chapter (``Philosophy'') give an introduction to GNUnet as a project, | 36 | Previously the documentation was contained in Drupal books, on the |
37 | what GNUnet tries to achieve. | 37 | old website. It was considered unmaintainable for the future, so |
38 | Texinfo was chosen. You might find old and very old sections in | ||
39 | here in addition to more recent content. It took a long time to | ||
40 | finish the move to Texinfo (from Drupal to LaTeX to wrong Texinfo | ||
41 | output dump to good Texinfo) and only recently (late 2018, early | ||
42 | 2019 content checking started. We apologize to the reader for | ||
43 | any inconvenience and hope you apply logic where bad advice from | ||
44 | 10 years ago can be found (pipe to sudo to install software is | ||
45 | one example). | ||
46 | |||
47 | The first chapter (``Preface'') as well as the the second chapter | ||
48 | (``Philosophy'') give an introduction to GNUnet as a project, what | ||
49 | GNUnet tries to achieve. ``Key Concepts'' explains the key concepts | ||
50 | in GNUnet. | ||
51 | These three chapters are the most complete in the documentation. | ||
52 | They are followed by chapters which need more work: | ||
53 | ``Installing GNUnet'', ``GNUnet Contributors Handbook'' and | ||
54 | ``GNUnet Developer Handbook''. | ||
38 | 55 | ||
39 | @node Contributing to this book | 56 | @node Contributing to this book |
40 | @section Contributing to this book | 57 | @section Contributing to this book |