I don't think that getting good-quality online docs is realistic for
Feisty. Better to concentrate on getting it right for Gutsy.

I had a look at a2m.xslt this evening. One problem seems to be with the
structure of the documentation - we're topic-based now, but whole
categories are contained within one file. On the wiki, it would be more
natural to have each topic on a separate page, but this doesn't seem to
be possible to do with an xslt. It'd require an extra script to break
each document up, which would have to handle linking and TOCs too.
Nasty.

While the HelpWikiQualityAssurance spec would undoubtedly be useful, I
think it should form part of a broader plan for the documentation. My
opinion is that we need to think long and hard about handling
categorisation and different versions (as you mentioned), and then get
some sort of concrete 'policy' in place. At the moment, I find the
documentation to be all too 'spread out'; things seem to be located
based on what type of documentation they are rather than where the user
would expect to find them.

-- 
Help for Current Release not found
https://bugs.launchpad.net/bugs/109284
You received this bug notification because you are a member of Ubuntu
Bugs, which is the bug contact for Ubuntu.

-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to