Creating documentation

[Dougie Richardson]

Hi Phil,

2009/4/28 Phil Bull <philbull at gmail.com>:
> It depends on what sort of work is being done. If someone is making a
> small patch, it's pretty pointless because doing the markup forms the
> bulk of the task.

We should make that clear but I think it'll be obvious to people when
they type out the bug report.

> If it's something more substantial, plain-text submission is fine. It
> should be encouraged, even! When you're writing documentation, the most
> important thing is the content, not the markup. I'd rather that new
> contributors spent their time thinking about their writing rather than
> grappling with DocBook.

I think this is definitely something we should promote.

> I don't think that we need a separate submission system. We can just
> have text files sent to the mailing list or attached to bugs.
>
> Teaching people how to markup text sounds like an ideal topic for an IRC
> session.

So do I, lets hope we get some submissions!

-- 
Regards,

Dougie Richardson
http://www.lynxworks.eu/
dougierichardson at ubuntu.com