Re: Doc in tex...

["Joshua D. Drake" <..hidden..>]

Chris Travers wrote:
> First, I think the plain text rendition is a very good idea.  As I
> say, it is one thing to tell accountants and bookkeepers to download
> LyX.  It is another to tell them to go to docbook.org and learn the
> format so they can contribute to the documentation effort.  Having an
> authoritative text rendition would allow people who don't want to have
> to learn a format to contribute.

Yeah text is easiest. You can actually transform fairly large text
documents into docbook with relative ease as well.

J


> 
> Best Wishes,
> Chris Travers
> 
> On 3/14/07, Jeff Kowalczyk <..hidden..> wrote:
>> --- 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
>>
>> -------------------------------------------------------------------------
>> Take Surveys. Earn Cash. Influence the Future of IT
>> Join SourceForge.net's Techsay panel and you'll get the chance to share your
>> opinions on IT & business topics through brief surveys-and earn cash
>> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
>> _______________________________________________
>> Ledger-smb-devel mailing list
>> ..hidden..
>> https://lists.sourceforge.net/lists/listinfo/ledger-smb-devel
>>
> 
> -------------------------------------------------------------------------
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to share your
> opinions on IT & business topics through brief surveys-and earn cash
> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
> _______________________________________________
> Ledger-smb-devel mailing list
> ..hidden..
> https://lists.sourceforge.net/lists/listinfo/ledger-smb-devel
> 


-- 

      === The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive  PostgreSQL solutions since 1997
             http://www.commandprompt.com/

Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate
PostgreSQL Replication: http://www.commandprompt.com/products/