This section lists some of the problems with the current system which this study hopes to address. General Documentation build system is fragile and difficult to maintain. UIUC does not build documentation locally because of the problems we've had trying to configure the system. Instead, we import the built documentation from Socorro. Since importing docs from Socorro, we have found that the HTML version of the Reference Manual regularly does not format argument lists properly.
Problems formatting equations and images are common but often go undetected by the make system.
Many of the formatting problems that currently exist can be traced to mark-up errors on the part of the author. Nevertheless, formatting errors are still quite common. This author's own difficulties are primarily due to the fact that the UIUC installation is not properly configured to build the documentation. If this is a common experience among developers, then the supporting tools are not sufficiently helpful in checking our documents. It is difficult to adjust the presentation of documentation.