Forschungsberichte Des Fachbereichs Informatik a Pragmatic Approach to Software Documentation a Pragmatic Approach to Software Documentation

We present an approach for designing a literate programming tool that, in addition to covering the technical issues, especially targets the acceptance of the documentation system by the program developer. We then describe the DosfOp documentation system for the Opal language, which was developed in line with these design principles. Finally, we discuss experiences with the system from a user's and from an implementor's point of view.