Jump to content

Documentation generator

From Wikipedia, the free encyclopedia
This is an old revision of this page, as edited by Stevebroshar (talk | contribs) at 17:00, 8 January 2025 (A generator is not necessarily a program (a tool); it's a capability; a service; a technology). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

In software development, a documentation generator is an automation technology that generates documentation. A generator is often used to generate API documentation which is generally for programmers or operational documents (such as a manual) for end users. A generator often pulls content from source code or binary files. Some generators, such as Javadoc and Doxygen, use special source code comments to drive content and formatting.

Types of generation

Document generation can be divided in several types:

  • Batch generation (generic technique)
  • Text block correspondence (documents created based on pre-defined text blocks)
  • Forms (forms for websites)
  • Documentation synthesis:
    • Documentation can be inferred from code
    • Documentation can be inferred from execution traces[1]

Some integrated development environments provide interactive access to documentation, code metadata, etc.

See also

References

  1. ^ Zhang, Sai; Zhang, Cheng; Ernst, Michael (2011). "Automated documentation inference to explain failed tests" (PDF). 2011 26th IEEE/ACM International Conference on Automated Software Engineering (ASE 2011). pp. 63–72. doi:10.1109/ASE.2011.6100145. ISBN 978-1-4577-1639-3. S2CID 14846118.