Re: Documentation consolidation

[t3sserakt]

Hey Martin,

I support your proposal!

t3ss

On 06.07.20 10:48, Schanzenbach, Martin wrote:
> 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

signature.asc
Description: OpenPGP digital signature