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 <[EMAIL PROTECTED]> wrote: >> --- Chris Travers <[EMAIL PROTECTED]> 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 >> [email protected] >> 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 > [email protected] > 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/ ------------------------------------------------------------------------- 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 [email protected] https://lists.sourceforge.net/lists/listinfo/ledger-smb-devel
