[<-] [ ^ ] [->] Previous: Intelligibility of the Code Up: Literate Programming and WEB Next: Organisation
Design Details in the Code
One frustrating feature of today's software industry is poor documentation,
particularly of new products from small companies. Documentation appears
late and is developed independently of the code.
Integrating the code and the documentation certainly encourages the two
being kept in step[+]. To put the design details in with the
code, we need
much more sophisticated typesetting techniques than are available within
the comment facilities of commonly used languages. Mathematics, tables,
and graphics at the very least are required. WEB is based on [LaTeX] thus
has all the power of one of the world's best typesetting environments.