[Top][All Lists]

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

Re: Documentation consolidation

From: t3sserakt
Subject: Re: Documentation consolidation
Date: Mon, 6 Jul 2020 10:58:29 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.9.0

Hey Martin,

I support your proposal!


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 
> And (for example): / 
> 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: OpenPGP digital signature

reply via email to

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