Fwd: Broken documentation

[Brendan Sleight <bms@barwap.com>]

Hi Brian,

On 22 February 2010 16:08, Brian Wilson wrote:
> ---------- Forwarded message ----------
> From: Brian Wilson
> Date: 22 February 2010 16:08
> Subject: Re: Broken documentation
> To: Brendan Sleight

Please reply to the list - shy users can benefit from the discussion.

>> http://live.debian.net/manual/html/meta.html#contributing
>> The instructions are quite detailed for add/contributing
>
> There is a step left out in between using git and "make build",
> do you have a reasonably good way to edit the xml files? Presumably that's
> how you go about doing edits?

I just edit the raw XML in a text editor. Although I have also used
AsciiDoc [1]  In other situations.

> 1 Edit the xml
> 2 make build
> 3 Look at HTML for errors
> 4 Submit changes to repo

Yep.

[1] - http://www.methods.co.nz/asciidoc/

Hope this helps,
Regards,
Brendan