diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/handbook/chapters/preface.texi | 23 |
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? |
5 | This 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? | ||
7 | This collection of manuals describes GNUnet, a framework | ||
6 | for secure peer-to-peer networking with the high-level goal to provide | 8 | for secure peer-to-peer networking with the high-level goal to provide |
7 | a strong foundation Free Software for a global, distributed network | 9 | a strong foundation for a global, distributed network |
8 | that provides security and privacy. | 10 | that provides security and privacy. |
9 | GNUnet in that sense aims to replace the current Internet protocol stack. | 11 | GNUnet in that sense aims to replace the current Internet protocol stack. |
10 | Along with an application for secure publication of files, it has grown to | 12 | Along with an application for secure publication of files, it has grown to |
@@ -24,7 +26,8 @@ Internet. | |||
24 | 26 | ||
25 | The books (described as ``book'' or ``books'' in the following) | 27 | The books (described as ``book'' or ``books'' in the following) |
26 | bundled as the ``GNUnet Reference Manual'' are based on the historic | 28 | bundled as the ``GNUnet Reference Manual'' are based on the historic |
27 | work of all contributors to GNUnet's documentation. It is our hope | 29 | work of all contributors to previous documentation of GNUnet. |
30 | It is our hope | ||
28 | that the content is described in a way that does not require any | 31 | that the content is described in a way that does not require any |
29 | academic background, although some concepts will require further | 32 | academic background, although some concepts will require further |
30 | reading. | 33 | reading. |
@@ -36,28 +39,32 @@ on a solution to describe the explanations found there which fits our | |||
36 | use-case and licensing. | 39 | use-case and licensing. |
37 | 40 | ||
38 | Previously the documentation was contained in Drupal books, on the | 41 | Previously the documentation was contained in Drupal books, on the |
39 | old website. It was considered unmaintainable for the future, so | 42 | old website. This format was considered unmaintainable for the future, so |
40 | Texinfo was chosen. You might find old and very old sections in | 43 | Texinfo was chosen. You might find old and very old sections in |
41 | here in addition to more recent content. It took a long time to | 44 | here in addition to more recent content. It took a long time to |
42 | finish the move to Texinfo (from Drupal to LaTeX to wrong Texinfo | 45 | finish the move to Texinfo (from Drupal to LaTeX to wrong Texinfo |
43 | output dump to good Texinfo) and only recently (late 2018, early | 46 | output dump to good Texinfo) and only recently (late 2018, early |
44 | 2019 content checking started. We apologize to the reader for | 47 | 2019) content checking started. We apologize to the reader for |
45 | any inconvenience and hope you apply logic where bad advice from | 48 | any inconvenience and hope you apply logic where bad advice from |
46 | 10 years ago can be found (pipe to sudo to install software is | 49 | 10 years ago can be found (pipe to sudo to install software is |
47 | one example). | 50 | one example). Patches (contributions) to this documentation are more |
51 | than welcome! | ||
48 | 52 | ||
49 | The first chapter (``Preface'') as well as the the second chapter | 53 | The 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 |
51 | GNUnet tries to achieve. ``Key Concepts'' explains the key concepts | 55 | GNUnet tries to achieve. ``Key Concepts'' explains the key concepts |
52 | in GNUnet. | 56 | in GNUnet. |
53 | These three chapters are the most complete in the documentation. | 57 | These three chapters are the most complete in the documentation. |
54 | They are followed by chapters which need more work: | 58 | They are followed by chapters which explain specific parts of |
59 | GNUnet (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. | ||
61 | The GNUnet Reference Manual is a collective work produced by various | 68 | The GNUnet Reference Manual is a collective work produced by various |
62 | people throughout the years. | 69 | people throughout the years. |
63 | 70 | ||