Comment 3 for bug 742857

On 30 March 2011 15:16, David Planella <email address hidden> 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