Re: Call for Documentation Contributors

From: Daniel Gerzo <danger_at_rulez.sk>
Date: Thu, 2 Sep 2010 19:54:39 -0300
I actually think there is some point in this idea. The problem is that many times we just leave notes or warnings specific for given releases, which can many times lead to confusion (or people just don't notice) and as time goes and we cut the support for given releases they get stale (e.g. We had many of those for 5.x).

We could just maintain the handbook in separate branches like we do with src, keeping them all built online, and merge relevant things where appropriate. This will, however, add quite a lot (for my taste) of additional work for us.

Daniel Gerzo

On 2.9.2010, at 5:02, Ed Schouten <ed_at_80386.nl> wrote:

> * Mehmet Erol Sanliturk <m.e.sanliturk_at_gmail.com> wrote:
>> Please separate Handbook with respect to distributions , i.e. , maintain a
>> different Handbook for each distribution .
> 
> The problem with that is that it will cause documentation for older, but
> still supported releases, to become stale. Most doc changes apply to
> functionality provided by both releases, or at least functionality that
> is MFC'd.
> 
> -- 
> Ed Schouten <ed_at_80386.nl>
> WWW: http://80386.nl/
Received on Thu Sep 02 2010 - 22:24:16 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:40:07 UTC