lubuntu-desktop team mailing list archive

[Jonathan Marsden <jmarsden@xxxxxxxxxxx>]

On 04/29/2011 11:31 PM, matthew byers wrote:

> These two are great start pages:
> https://wiki.ubuntu.com/DocumentationTeam/Wiki
> this second page is more focused on guidelines and syntax:
> https://help.ubuntu.com/community/WikiGuide

Thanks, read and bookmarked.

QUESTION #1:

One issue I did not find clear info on is the combining of a #title line
to provide a readable title when you also need tags.  Per
https://help.ubuntu.com/community/Tag :

  Tags should be added at the very top of a page, before any other
  text.

However, this causes #title to fail (it gets treated as normal text and
displayed!).  But putting #title before the tag includes cause the
includes not to display, as far as I can tell!

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

QUESTION #2:

That style guide also claims to apply to the help wiki, but it has a
major section about docbook tags in it, at
https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocbookConventions
.  Can we *really* add docbook markup tags to wiki pages and expect them
to do the right thing?  That would be very cool, and sometimes useful --
but I don't think it would work!

Jonathan