Missing internal documentation

[Jim Campbell]

Hi All,

On Wed, Apr 22, 2009 at 4:32 PM, Matthew East <mdke at ubuntu.com> wrote:

> Building web pages and PDF was already covered, but I've updated the
> pages, added a section on help.ubuntu.com and renamed the pages to
> match the new "SystemDocumentation" naming convention:
>
>
> https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/BuildingDocumentation
>
> I've added a paragraph to that page briefly explaining XSL templates.
> I think a brief explanation is appropriate rather than a detailed one
> because there are some very good and comprehensive guides to XSL
> elsewhere on the internet, and I've included a link to one of those.
>
> I've added a brief explanation of the layout of the branch to the
> https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Editing
> page.
>
> I've added a short explanation of entities here:
> https://wiki.ubuntu.com/DocumentationTeam/DocbookTags
>
> Feel free to review/amend these.
>
> Also I'd encourage anyone who sees a gap in the internal documentation
> for the team to post on this thread, or better still, propose some
> wording that we can add.
>

I've had a look through these, and they look helpful. Thanks for putting
these together.

I think these pages do a good job of describing a good number of the
elements that are shared between the various Ubuntu flavors (entities,
docbook tags, etc.), but we should also look to put a separate page together
that highlights differences between the ubuntu flavors. For example, neither
Xubuntu nor Kubuntu uses .omf files, but Ubuntu does . . . we should also
details how the the Xubuntu and Kubuntu docs get built, etc.

I would like to wait until after we have our upcoming team meeting before
staring these additional pages, though.

Thanks again for getting a start on things,

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