Automatic documentation generator

摘要

The subject matter disclosed herein provides methods and apparatus, including computer program products, for generating a list of object descriptions based on an object's relevance for documentation. In one aspect there is provided a method that may include accepting a setting for a filter and a setting for a flag of an object. The filter setting may represent a type of information to be included in a list of object descriptions. The flag setting may represent a category of documentation relevance for the object that may be stored in a repository. The method may include comparing the filter setting with the flag setting of the object, extracting the description of the object from the repository based on the comparing of the flag setting with the filter setting, and generating the list of object descriptions that includes a description of the object. Related systems, apparatus, methods, and/or articles are also described.

主权项

1. A non-transitory computer-readable medium containing instructions to configure a processor to perform operations comprising:
accepting a setting for a filter, the filter setting representing a type of information to be included in a list of object descriptions, the type corresponding to at least one of an end-user version of a software documentation or a technical version of the software documentation; accepting a setting for a flag of an object, the flag setting representing a category of documentation relevance for the object stored in a repository, the flag setting corresponding to at least one of a first indication that the object is relevant for the end-user version of the software documentation or a second indication that the object is relevant for the technical version of the software documentation, a third indication that the object is conditional upon the acceptance of another object for inclusion in the software documentation, and a fourth indication that the object is always relevant to generation of the software documentation; comparing the filter setting with the flag setting of the object to determine whether the object is to be included in the software documentation; extracting a description of the object from the repository, when the comparing indicates a match between the filter setting and the flag setting; and generating the list of object descriptions, the list including the description of the object; and generating the software documentation from the generated list of object descriptions.