[GNUnet-SVN] [gnunet] branch master updated: preface: removed fixed TODO notes, add XXX notes, adjust content, fix grammar.

[gnunet]

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 c6fdc95b0 preface: removed fixed TODO notes, add XXX notes, adjust 
content, fix grammar.
c6fdc95b0 is described below

commit c6fdc95b014a274406499ac73de8d23112ed7784
Author: ng0 <address@hidden>
AuthorDate: Mon Mar 18 17:12:40 2019 +0000

    preface: removed fixed TODO notes, add XXX notes, adjust content, fix 
grammar.
---
 doc/handbook/chapters/preface.texi | 71 +++++++++++++++++++++-----------------
 1 file changed, 40 insertions(+), 31 deletions(-)

diff --git a/doc/handbook/chapters/preface.texi 
b/doc/handbook/chapters/preface.texi
index 4b6610d2c..98ae6d4e5 100644
--- a/doc/handbook/chapters/preface.texi
+++ b/doc/handbook/chapters/preface.texi
@@ -1,13 +1,15 @@
 @node Preface
 @chapter Preface
 
address@hidden FIXME: Long sentence is long.
 This collection of manuals describes how to use 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
-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 include
-all kinds of basic applications for the foundation of a new Internet.
+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
+include all kinds of basic applications for the foundation of a new
+Internet.
 
 @menu
 * About this book::
@@ -57,29 +59,34 @@ They are followed by chapters which need more work:
 @section Contributing to this book
 
 The GNUnet Reference Manual is a collective work produced by various
-people throughout the years. The version you are reading is derived
-from many individual efforts hosted on our website. This was a failed
-experiment, and with the conversion to Texinfo we hope to address this
-in the longterm. Texinfo is the documentation language of the GNU project.
+people throughout the years.
+
+The version you are reading is derived
+from many individual efforts hosted on one of our old websites.
+In the end it was considered to be impractical to read by
+those who required the information.
+With the conversion to Texinfo --- the version you are reading
+right now --- we hope to address this in the longterm.
+Texinfo is the documentation language of the GNU project.
+
 While it can be intimidating at first and look scary or complicated,
-it is just another way to express text format instructions. We encourage
-you to take this opportunity and learn about Texinfo, learn about GNUnet,
-and one word at a time we will arrive at a book which explains GNUnet in
-the least complicated way to you. Even when you don't want or can't learn
-Texinfo, you can contribute. Send us an Email or join our IRC chat room
-on freenode and talk with us about the documentation (the prefered way
-to reach out is the mailinglist, since you can communicate with us
-without waiting on someone in the chatroom). One way or another you
-can help shape the understanding of GNUnet without the ability to read
-and understand its sourcecode.
+it is just another way to express text format instructions.
+
+We encourage you to take this opportunity and learn about Texinfo,
+learn about GNUnet, and one word at a time we will arrive at a
+book which explains GNUnet in the least complicated way to you.
+
+Even when you don't want to or can't learn Texinfo, you can contribute.
+Send us an Email or join our IRC chat room on freenode and talk with
+us about the documentation (the prefered way to reach out is the
+mailinglist, since you can communicate with us without waiting on
+someone in the chatroom).
+One way or another you can help shape the understanding of GNUnet
+without the ability to read and understand its sourcecode.
 
 @node Introduction
 @section Introduction
 
address@hidden In less than 2 printed pages describe the history of GNUnet here,
address@hidden what we have now and what's still missing (could be split into
address@hidden subchapters).
-
 GNUnet in its current version is the result of almost 20 years of work
 from many contributors.  So far, most contributions were made by
 volunteers or people paid to do fundamental research.  At this stage,
@@ -126,12 +133,17 @@ social network, resulting in a significant growth of the 
core team.
 In 2013, we launched @uref{https://taler.net, GNU Taler} to address
 the challenge of convenient
 and privacy-preserving online payments.  In 2015, the
address@hidden TODO: Maybe even markup for the E if it renders in most outputs.
address@hidden://pep.foundation/, pEp} (pretty Easy privacy) project
address@hidden XXX: It is not correct to refer to pEp as pEp stylistic,
address@hidden XXX: but the correct version would lead to problems with
address@hidden XXX: some of our outputs and/or older versions of texinfo
address@hidden XXX: and devices that display versions on consoles etc.
address@hidden XXX: This is why we keep the pEp until proven that p(tripple 
bar)p
address@hidden XXX: does not create broken outputs.
address@hidden://pep.foundation/, pretty Easy privacy} (pEp) project
 announced that they will use GNUnet as the technology for their
 meta-data protection layer, ultimately resulting in GNUnet e.V.
 entering into a formal long-term collaboration with the pEp
-foundation.  In 2016, Taler Systems SA, a first startup using GNUnet
+Foundation.  In 2016, Taler Systems SA, a first startup using GNUnet
 technology, was founded with support from the community.
 
 GNUnet is not merely a technical project, but also a political
@@ -148,7 +160,7 @@ Similarly its flaws are not limited to the protocol design. 
 Thus,
 technical excellence by itself will not suffice to create a better
 network. We also need to build a community that is wise, humble and
 has a sense of humor to achieve our goal to create a technical
-foundation for a society we would like to live in. 
+foundation for a society we would like to live in.
 
 
 @node Project governance
@@ -159,15 +171,12 @@ follows the governance model of a benevolent dictator.  
This means
 that ultimately, the GNU project appoints the GNU maintainer and can
 overrule decisions made by the GNUnet maintainer. Similarly, the
 GNUnet maintainer can overrule any decisions made by individual
address@hidden TODO: Should we mention if this is just about GNUnet? Other 
projects
address@hidden TODO: in GNU seem to have rare issues (GCC, the 2018 
documentation
address@hidden TODO: discussion.
 developers.  Still, in practice neither has happened in the last 20
-years, and we hope to keep it that way.
+years for GNUnet, and we hope to keep it that way.
 
 @c TODO: Actually we are a Swiss association, or just a German association
 @c TODO: with Swiss bylaws/Satzung?
address@hidden TODO: Rewrite one of the 'GNUnet eV may also' sentences.
address@hidden TODO: Rewrite one of the 'GNUnet eV may also' sentences?
 The GNUnet project is supported by GNUnet e.V., a German association
 where any developer can become a member.  GNUnet e.V. serves as a
 legal entity to hold the copyrights to GNUnet.  GNUnet e.V. may also

-- 
To stop receiving notification emails like this one, please contact
address@hidden