Excessively complex, redundant markup in Ubuntu Server Documentation

changed source package to ubuntu-docs

I think what you are referring to here is the HTML markup, rather than the original markup of the document, which is written in Docbook XML. The conversion of the document to HTML is performed by a parser called xsltproc and stylesheets supplied by the docbook-xsl package - the ubuntu-doc team doesn't have the time or the ability to modify the individual HTML markup used by these tools for specific commands. Ubuntu Server users will generally have enough bandwidth to download the few extra characters used by the markup. For that reason I'm closing the bug as "won't fix". If you want to pursue the principle upstream with docbook-xsl, you'll find information here: http://wiki.docbook.org/topic/DocBookXslStylesheets

Let's wait on closing the bug until we actually *know* the source of the problem.

If the document on the Ubuntu web site:

https://help.ubuntu.com/9.10/serverguide/C/

is not the original, please post the link to the Docbook, TEI-lite, or ISO 12083 version that is the original.

There isn't an obvious mention in the documentation of the existence of an original or the method that was used to generate the XHTML..

Lars - I'm not sure why you say that we don't know the source of the problem, I'm pretty confident that I know which tools ubuntu-docs uses for building HTML, since I'm responsible for doing it.

Anyway, you can see the source code for the document in the bzr branch at lp:ubuntu-docs. You can browse it through a website here:

http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-docs/lucid/files/head%3A/serverguide/C/

Matthew - because the phrase 'I think' is, even on launchpad, usually followed by unsubstantiated claims usually easily proven wrong by checking with an authoritative source. In this case, since you are the one building the HTML documents out of the Docbook versions, you yourself are an authority on the topic.

Thanks for the bazaar link. It is what I was looking for but did not know about.

In the eagerness to cancel the bug, it is overlooked that the error stems from the package 'docbook-xsl' which used to make the conversion to HTML.

There are plans to "clean" the (X)HTML output of docbook-xsl. So you can leave this open. However, this is not a short term goal. So it might stay open for a while.