Re: Doc in tex...

[Jeff Kowalczyk <..hidden..>]

--- Chris Travers <..hidden..> wrote:
> Also one question that was brought up before and never really answered
> (I thought) was how we want to encourage non-technical users to
> contribute documentation. 
> (...)
> 2)  What formats will we accept documentation edits in?  Do we want to
> force bookkeepers and accountants to learn DocBook, or are HTML
> submissions fine?

I would encourage a plain-text 80-column wrapped rendering of the LaTeX or
DocBook source checked in to the repository. The plain-text should be rendered
after each LaTeX/DocBook source edit before commit, which is a small
housekeeping burden.

Accept tracker bugs_patches on that, but don't commit the patches. The
documentation maintainers can take the patch and apply the described change in 
the technical format, LaTeX/DocBook.

I think that even a non-technical documentation reviewer can learn to make a
diff against a plain-text documentation file and upload it to a bug tracker.
The few who can't will probably find someone willing to help, or at least those
proposed edits will be to a simple format.  



 
____________________________________________________________________________________
Get your own web address.  
Have a HUGE year through Yahoo! Small Business.
http://smallbusiness.yahoo.com/domains/?p=BESTDEAL