The source for all UML documentation is XML, with a set of tags invented, ad-hoc, one-the-fly, by me. This is processed into the UML web site and the HOWTO with XSL, using Transformiix, which is the Mozilla XSL processor.

The documentation source is in CVS under /doc/web. A variety of files are located here:

• XML files - the documentation source itself
• Makefile - the Makefile knows how to build and sync the web site, and how to build the HOWTO, as both HTML and text.
• sgml.xsl and uml.xsl - the XSL scripts, sgml.xsl builds the SGML source for the HOWTO, which is converted into HTML and text with the sgml-tools utilities, and uml.xsl builds the web site.
• md.pl - a little perl script which combines page.xml, which is the web boilerpate, into a single XML document which each of the other XML files. This allows Transformiix to combine them into an HTML file.
• sgml.pl - another little perl script which combines a subset of the XML files into a single XML document along with some other bits of information. This combined document is then converted into the SGML source file for the HOWTO.

In addition, there are a large number of files which are copied verbatim into the site. These include

• A number of pictures
• UML slides and papers from various conferences, in various forms
• A few text files
• All of the UML patches which have been sent to Alan, since I reference these from my diary

Some things were already mentioned:

• Checking the site for spelling and grammar errors
• Checking it for untrue statements, particularly HOWTOs that don't work as advertised
• Looking for HOWTOs, that while technically are true, do not describe the best, quickest, or simplest way to get the job done

The aesthetics of this site may not be the best. Improvements are welcome. Also, there are a lack of diagrams and pictures which might help clarify things. Contributions would also be welcome.

Improvements to the layout and organization would be good. It might also be nice to have some kind of automatically generated news section on the main page which lists the latest UML happenings or the latest site updates.

This site mostly contains HOWTO-type material. If you would like to see other sorts of things here, speak up, or write it up and send it in.

The utilities that ship with UML need man pages. I'd like XML source that can be converted into man page source, HTML, and SGML. It's OK if all these outputs look something like man pages. We can add new sections to the site and the HOWTO for them.

The XML tagset being used here is probably not the world's most sane XML schema. Improvements and simplifications would be welcome. Also, the abstract tags are not used everywhere they should be.

The site needs an advanced networking page. This should cover things like

• Multiple UMLs networking via the host
• Setting up a virtual network with one or more nodes acting as gateways to the host
• Bridging - I have a walkthrough which needs to be incorporated
• Maybe setting up IPv6
• Setting up a ppp link over a UML console or serial line in order to run what amounts to a dial-up connection to the host. Also, setting up the serial lines of two UMLs so that one can dial up to the other.