Re: Documentation consolidation

[xrs]

+1

On Mon, 6 Jul 2020 10:58:29 +0200
t3sserakt <t3ss@posteo.de> wrote:

> 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  
>

pgptDwLh6pfZ6.pgp
Description: OpenPGP digital signature