From e5268d826a72dab5c10f6228303cc728d865ef64 Mon Sep 17 00:00:00 2001 From: Nils Gillmann Date: Wed, 4 Jul 2018 20:06:07 +0000 Subject: Documentation: Typo fixes, links. Signed-off-by: Nils Gillmann --- doc/documentation/chapters/preface.texi | 40 +++++++++++++++++++++++---------- 1 file changed, 28 insertions(+), 12 deletions(-) (limited to 'doc/documentation') diff --git a/doc/documentation/chapters/preface.texi b/doc/documentation/chapters/preface.texi index 00e6290f0..3bc38941d 100644 --- a/doc/documentation/chapters/preface.texi +++ b/doc/documentation/chapters/preface.texi @@ -66,25 +66,33 @@ immediately. A few months after the first release we contacted the GNU project, happily agreed to their governance model and became an official GNU package. -Within the first year, we created GNU libextractor, a helper library +Within the first year, we created +@uref{https://gnu.org/s/libextractor, GNU libextractor}, a helper library for meta data extraction which has been used by a few other projects as well. 2003 saw the emergence of pluggable transports, the ability for GNUnet to use different mechanisms for communication, starting with TCP, UDP and SMTP (support for the latter was later dropped due to a lack of maintenance). In 2005, the project first started to evolve beyond the original file-sharing application with a first -simple P2P chat. In 2007, we created GNU libmicrohttpd +simple P2P chat. In 2007, we created +@uref{https://gnu.org/s/libmicrohttpd, GNU libmicrohttpd} to support a pluggable transport based on HTTP. In 2009, the architecture was radically modularized into the multi-process system -that exists today. Coincidentally, the first version of the ARM +that exists today. Coincidentally, the first version of the ARM@footnote{ARM: Automatic Restart Manager} service was implemented a day before systemd was announced. From 2009 to 2014 work progressed rapidly thanks to a significant research grant from the Deutsche Forschungsgesellschaft. This resulted in particular in the creation of the R5N DHT, CADET, ATS and the GNU Name System. -In 2010, GNUnet was selected as the basis for the SecuShare online -social network, resutling in a significant growth of the core team. -In 2013, we launched GNU Taler to address the challenge of convenient -and privacy-preserving online payments. In 2015, the pEp project +@c So is it secushare or SecuShare? +In 2010, GNUnet was selected as the basis for the +@uref{https://secushare.org, SecuShare} online +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 +@c TODO: URL for pEp. Maybe even markup for the E if it renders in +@c TODO: most outputs. +@uref{https://pep.org, pEp}@footnote{pretty easy privacy} 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 @@ -99,9 +107,9 @@ computing has been the core driver of the GNU project. With GNUnet we are focusing on informational self-determination for collaborative computing and communication over networks. -The Internet is shaped as much by code and protocols as by its -associated political processes (IETF, ICANN, IEEE, etc.), and its -flaws are similarly not limited to the protocol design. Thus, +The Internet is shaped as much by code and protocols as it is by its +associated political processes (IETF, ICANN, IEEE, etc.). +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 @@ -116,15 +124,21 @@ 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 +@c TODO: Should we mention if this is just about GNUnet? Other projects +@c TODO: in GNU seem to have rare issues (GCC, the 2018 documentation +@c TODO: discussion. developers. Still, in practice neither has happened in the last 20 years, 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? +@c 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. servers as a +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 choose to pay for project resources, and can collect donations. GNUnet e.V. may also choose to adjust the license of the -software (with the constraint that it has to remain free software). +software (with the constraint that it has to remain free software)@footnote{For example in 2018 we switched from GPL3 to AGPL3. In practice these changes do not happen very often.} @node General Terminology @@ -142,3 +156,5 @@ command should/can be issued as root, or if "normal" user privileges are sufficient. We use a @code{#} for root's shell prompt, a @code{%} for users' shell prompt, assuming they use the C-shell or tcsh and a @code{$} for bourne shell and derivatives. +@c TODO: Really? Why the different prompts? Do we already have c-shell +@c TODO: examples? -- cgit v1.2.3