lubuntu-desktop team mailing list archive

[Jonathan Marsden <jmarsden@xxxxxxxxxxx>]

Jared,

Earlier I asked:

>> What is the correct way to have both a #title line and tags on the
>> same page?

>> A page on which this is currently attempted (but not really working) is
>>   https://wiki.ubuntu.com/DocumentationTeam/StyleGuide

On 05/01/2011 02:17 PM, Jared Norris wrote:

> I spent an hour trying to solve this and the best I can come up with
> is that that page is referencing a help.u.c link (Tag/ContentCleanup)
> from within a wiki.u.c site ...

Ah, OK, that is an issue for the person who added the tags (undifined)
not me messing up when adding the #title line, then :)

I suppose this leads to a higher level question: is there a common
(standardized?) set of tags that work on both wiki.ubuntu.com and
help.ubuntu.com, and where is that tag set documented?

>> Can we *really* add docbook markup tags to wiki pages and expect
>> them to do the right thing?

> The documentation team is not just about wiki pages.

That's understood, but the StyleGuide tells us itself that it applies to
the help.ubuntu.com wiki, saying on that first page linked to above,
under the heading "Style Guide Applicability and Precedence", that:

    The Documentation Team also takes care of the documentation
    wiki, to which the style guide also applies.

So if it fully applies... that would mean one can use docbook markup in
the wiki!  I suspect that sentence needs editing to exclude
docbook-specific things in the StyleGuide?

BTW, I used to be fully DocBook-capable, with Emacs + sgml-mode + jade
and all that stuff... but that was about 8 years ago, I've forgotten a
lot of it now :)

> So this information is put up on the wiki but actually refers to
> their work in the DocBook documentation.

The StyleGuide itself says otherwise, and so should be edited if you are
correct that it no longer applies to help.ubuntu.com wiki materials.

Jonathan