On 30 March 2011 15:16, David Planella <[email protected]> wrote:
> * The ubuntu-docs package is aimed at topic-based user documentation, so
> I'm not too sure this is the right place for it, as it describes things
> as the LC_* variables, which are too advanced for general consumption.
> It might be worth adding the documentation to the language-selector
> package itself.

On the basis of a quick review, I would tend to agree with David -
although the document looks very solid and the work done is very
impressive, the approach and level of detail is probably not
appropriate for desktop user help. I would prefer to have this sort of
document in the wiki, with more high level usage instructions kept for
the language-selector package and a link to that from the ubuntu-docs
package. The nuts and bolts of gettext don't need to be explained for
the vast majority of our users, they just need to know how to install
and change languages.

> * The docs team (and other projects in general) don't work directly on
> XML. They rather create a document in a documentation format such as
> docbook

That's ok - the document format looks ok. Docbook is a type of xml.

-- 
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/742857

Title:
  i18n matters ought to be properly documented

-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to