5 Good style and organisation

In Section 2.1 we listed the Starlink documents which the users voted the best available. Do these have any common features which can be used as guides for ones own writing? We took a close look at them, and all or most of them have the following characteristics:

Any non-trivial document describing a software package or routine library should have this sort of sectioning. Some (such as SUN/1 which surveys the whole of Starlink software) can also benefit from having an index (much easier to produce with the new version of LATEX).

We also recommend the following further characteristics for your Starlink user documents:

Starlink is trying to achieve a common style in all its documents, particularly in their format, so as to present a professional and uniform image. To achieve this, we request that you include in your documents the standard elements specified in appendix A.