gnunet-developers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Documentation consolidation


From: Schanzenbach, Martin
Subject: Documentation consolidation
Date: Mon, 6 Jul 2020 10:48:31 +0200

Hi,

while doing a rough check over the handbook I noticed that we have duplicate 
infos on the webpage
and the handbook. Specifically with respect to installation.

See 
https://docs.gnunet.org/handbook/gnunet.html#Building-GNUnet-and-its-dependencies
And (for example): https://stage.gnunet.org/en/install-on-debian9.html / 
https://stage.gnunet.org/en/install.html

In my opinion we should consolidate this. The infos in the handbook are 
unfortunately outdated,
so are some of the OS specific tutorials.
Building from source is a developer thing, so I firmly believe that it belongs 
in the developer section
of the handbook. Duplication on the homepage is difficult to maintain.

My proposal:
- Move and merge all "from source" installation instructions to the handbook.
- Recommend using packages on the homepage to users.
- Link from the homepage (Developers/Install section) to the developer handbook 
installation instructions for developers/early adopters.

Migration from the web pages to the handbook will have the positive side-effect 
that authors of
OS-specific pages will have to update the contents (or be omitted in the 
transition).

Of course the alternative to the above is to remove installation instructions 
from the handbook.
But that is not a good idea as the handbook should be self-contained.

BR
Martin

Attachment: signature.asc
Description: Message signed with OpenPGP


reply via email to

[Prev in Thread] Current Thread [Next in Thread]