Doctypes define document properties and document sections. Each property may have a value or not, each section may have content or not. Note Box |
---|
To be precise, only the Doctype, the Name and the Short Description have to be defined. All other properties may have blank values. The system only complains if the doctype is missing. The name should be present and it is good practice to have a short description. |
If a property has no value or a section has no content, it is not rendered. Therefore a doctype is not a template that requires to be filled out. It is a tool to guide authors to create new documents based on the team's conventions. Authors may add new properties and sections and remove all non-mandatory properties and all sections, if they think these do not apply. But since empty content is not displayed to the reader, it is good practice to leave them in the template. If in the future a new information has to be added, the author still has the guidance provided by the doctype to add it to the location defined by the team's convention. |