//Artefact:Language/org/doclets/Language (2.0)
Introduction
Doclets
Holistic documentation.
Creation and maintenance of quality documentation is a
challenging task. A well known approach is to ease
maintenance by integrating it into regular daily
routine. This enables continous work and fits well with
agile setups.
The integration into daily routine works by writing
documentation snippets into work artefacts, i.e.
usually source code. Then, these snippets are extracted
automatically from the source and combined into an
easily accesible format, like a webpage.
This approach works well for API documentation.
There are three issues with this approach. First,
different levels of maturity
different audiences
missing several important artefacts