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

Re: live-manual style guide



On 02/07/2012 03:06 PM, Ben Armstrong wrote:
> I would argue to keep all our documentation in one place

exactely, and just to reiteratate and emphasis on that, we have
'information' in three places:

  * manpages: *low-level reference* information only (i.e. what
    parameters exist, what options are valid; but nothing more)

  * wiki: *development centric*, few little bits of information only
    that don't make sense to be put into the manual or don't fit (i.e.
    build status information, todo lists).

  * manual: absolutely everything else :)

-- 
Address:        Daniel Baumann, Donnerbuehlweg 3, CH-3012 Bern
Email:          daniel.baumann@progress-technologies.net
Internet:       http://people.progress-technologies.net/~daniel.baumann/


Reply to: