Learn about properties and sections of a document.
Doctypes define document properties and document sections. Each property may have a value or not, each section may have content or not.
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.
If you want to add metadata to a given document, add it to the table within the Document Properties Marker Macro at the top of the page. This is a simple name/value list with an additional column that contains row controls.
While a document type requires a certain set of properties to be present, authors may add any property they require. But keep in mind that it is difficult to remember properties that are not standard. Further more it is sometimes very difficult to sense the meaning of document properties that are not documented.
Doctypes not only provide a basic structure by the use of properties and sections. They also provide a wizard that supports authors to create documents. A wizard is a step by step guidance to collect information to be added to the new document.
Agile documentation proposes to have documentation that is
- valuable - has a stakeholder that is in need for the information
- essential - contains only the required information for the stakeholder
- timely - create just-in-time for the stakeholder
With this in mind it is important to be able to define the doctypes according to the team's requirements. Therefore all our doctype add-ons are available for free on the Marketplace and are published with an open source license on Bitbucket. Feel free to use them as a basis to define your own set of doctypes.
If you need only minor changes to the doctypes, which especially do not require changes to the blueprint wizard, you may simply edit the installed templates of the free doctypes.
Please note that we are constantly working on the doctypes. Make sure that you understand the additional work you have to invest in developing your own version of the doctypes.
Create a Person Document
- If there is a homepage for Person document on the workspace space: Delete it!
- Go to your
- Create a document of type
- Provide a name (given and family) and short description
- Check the '
Send to Homepage' box
- Click '
- Add a new property to the properties table
- Click '
My Workspace space has no homepage for documents of type persons and the '
Send to Homepage' box has been checked, the document is stored on the person homepage of the delegate space.
Select Document Property
Now go to the person's homepage on the index space and change the properties selected from the documents.
- Go to person homepage of the index space
- Edit person homepage
- Set the following properties to the select parameter of the Display Table Macro:
Name, Short Description, Team
- Save the changes to the macro
- Save the page
The additional column is shown on the homepage.
Continue with the next step: The Workhorse Macros