The projectdoc Toolbox provides doctypes and macros to support teams to modularize their documentation.

Single sourcing is an approach to reuse content by making sure that each piece of information has only one authoritative location.

There are a couple of tools in the projectdoc Toolbox to support single sourcing:

  1. The Section Macro and the Content Marker Macro allow to define pieces of information on a projectdoc Document. Using the Transclusion Macro or the Transclude Documents Macro the content, defined in a single location, can be rendered on any other page.
  2. Also Dynamic Linking allows to automatically pick sections from other documents.
  3. The Module and Module Type doctypes allow to specify a piece of information on a separate document. By defining types of modules, the individual pieces may be organized to be found by browsing. Additionally the documents may provide additional metadata used to filter or be provided as helpful information for other authors.

Resources

More information on single sourcing.

Single Sourcing
Description of single sourcing as a practice: Reduce redundancy by having one source of truth for each information. This way the written information is more easily reusable in other documents and - which is even more important - it is referenceable. Single sourcing demands automation.
Single Sourcing
Entry in the glossary: Method for systematically re-using information.
Transclusion
The technique to render parts of one document within another document.
Multi-transclusion
Describes the technique to transclude one or more content fragments from one or more documents.
Dynamic List
Enhances navigation by showing a list of links to related information that is the result of a query on document properties.

More Features

List of features of the projectdoc Toolbox for Confluence.

The query matched no documents.