Creating documentation

[Jim Campbell]

Hi Dougie,

On Sun, Apr 26, 2009 at 1:59 PM, Dougie Richardson <
dougierichardson at ubuntu.com> wrote:

> Hi all,
>
> I was thinking that DocBook and our toolchain is frequently suggested
> as putting people off of contributing, would it be possible to create
> a text based submission system that those familiar with DocBook could
> wrap?
>
> I find it awkward to read patches that are wrapped anyway and wouldn't
> mind wrapping them myself.
>
> How we would we control it and would people be interested? Could we
> use it as a teaching tool for some of our IRC sessions - talk through
> creating a new page from a submitted text file? Would this be a lot of
> work?
>
> Thoughts?
>

I'm not sure what you mean when you say, "wrap."  Are you thinking that the
person would just write the text, and doc team members would add the docbook
elements?

What about looking into some of the moin-moin-to-docbook functionality? I
think this may have been investigated a few years ago, but that the
functionality may have improved since it was last discussed.

Jim
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20090427/1664e29f/attachment.html>