[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [gnunet] branch master updated: handbook: fixes and comment
From: |
gnunet |
Subject: |
[GNUnet-SVN] [gnunet] branch master updated: handbook: fixes and comments in preface |
Date: |
Mon, 01 Apr 2019 16:17:30 +0200 |
This is an automated email from the git hooks/post-receive script.
ng0 pushed a commit to branch master
in repository gnunet.
The following commit(s) were added to refs/heads/master by this push:
new dcdd00d13 handbook: fixes and comments in preface
dcdd00d13 is described below
commit dcdd00d1378ca65397486c1f9653321f8daac268
Author: ng0 <address@hidden>
AuthorDate: Mon Apr 1 14:17:23 2019 +0000
handbook: fixes and comments in preface
---
doc/handbook/chapters/preface.texi | 23 +++++++++++++++--------
1 file 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 @@
@node Preface
@chapter Preface
address@hidden FIXME: Long sentence is long.
-This collection of manuals describes how to use GNUnet, a framework
address@hidden FIXME: Do we have to mention that this is Free Software?
address@hidden FIXME: where did 'Free Software' in this sentence fit before
address@hidden FIXME: we changed it?
+This collection of manuals describes GNUnet, a framework
for secure peer-to-peer networking with the high-level goal to provide
-a strong foundation Free Software for a global, distributed network
+a strong foundation for a global, distributed network
that provides security and privacy.
GNUnet in that sense aims to replace the current Internet protocol stack.
Along with an application for secure publication of files, it has grown to
@@ -24,7 +26,8 @@ Internet.
The books (described as ``book'' or ``books'' in the following)
bundled as the ``GNUnet Reference Manual'' are based on the historic
-work of all contributors to GNUnet's documentation. It is our hope
+work of all contributors to previous documentation of GNUnet.
+It is our hope
that the content is described in a way that does not require any
academic background, although some concepts will require further
reading.
@@ -36,28 +39,32 @@ 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
+old website. This format 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
+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).
+one example). Patches (contributions) to this documentation are more
+than welcome!
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:
+They are followed by chapters which explain specific parts of
+GNUnet (and need more work):
``Installing GNUnet'', ``GNUnet Contributors Handbook'' and
``GNUnet Developer Handbook''.
@node Contributing to this book
@section Contributing to this book
address@hidden FIXME: There's a good amount of repetition here, we should
address@hidden FIXME: fix this.
The GNUnet Reference Manual is a collective work produced by various
people throughout the years.
--
To stop receiving notification emails like this one, please contact
address@hidden
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] [gnunet] branch master updated: handbook: fixes and comments in preface,
gnunet <=