summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNils Gillmann <ng0@n0.is>2018-07-08 19:12:20 +0000
committerNils Gillmann <ng0@n0.is>2018-07-08 19:12:20 +0000
commit3208b4d3ea802ad56a50dcc63fe70e428a5eca5d (patch)
tree91c3d6d4019e59f12ae40dbff039f1c232b37d0c /doc
parentb35da95733c873d6bb625764fd3c43c76a7172f7 (diff)
Documentation: Contributing to this book. A motivational short section on how and why to contribute to the book.
Signed-off-by: Nils Gillmann <ng0@n0.is>
Diffstat (limited to 'doc')
-rw-r--r--doc/documentation/chapters/preface.texi21
-rw-r--r--doc/documentation/gnunet.texi1
2 files changed, 22 insertions, 0 deletions
diff --git a/doc/documentation/chapters/preface.texi b/doc/documentation/chapters/preface.texi
index 65e627368..12abc2b7b 100644
--- a/doc/documentation/chapters/preface.texi
+++ b/doc/documentation/chapters/preface.texi
@@ -12,6 +12,7 @@ all kinds of basic applications for the foundation of a new Internet.
@menu
* About this book::
+* Contributing to this book::
* Introduction::
* Project governance::
* General Terminology::
@@ -37,6 +38,26 @@ 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.
+@node Contributing to this book
+@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.
+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.
+
@node Introduction
@section Introduction
diff --git a/doc/documentation/gnunet.texi b/doc/documentation/gnunet.texi
index 3cce4deb8..d60f484db 100644
--- a/doc/documentation/gnunet.texi
+++ b/doc/documentation/gnunet.texi
@@ -101,6 +101,7 @@ This document is the Reference Manual for GNUnet version @value{VERSION}.
Preface
* About this book
+* Contributing to this book
* Introduction
* General Terminology::
* Typography::