Resources are identified by their type. This is not the MIME type, but human readable string, that identifies the semantic, rather than the syntactic format.
Description
Allows grouping resources by type, the resource type also helps readers to set their expectations of the resource document's content.
Properties
The document type resource type provides the following properties:
Sections
Description
A detailed description of the resource type.
This helps authors to select the appropriate type for their resources.
Subordinate Resource Types
Group resource types by putting them in a hierarchy.
Resources of this Type
An overview over resources of this type.
Notes
These are internal notes that are usually not exported and only visible to team members with write access.
But this is not a safe place to store sensible information. It is just a convenience for the reader to not be bothered with notes stored here for the authors for later use. The security level is about suppressing the representation by a CSS style. Therefore consider this as a convenience for the reader, not as a security tool.
References
For a document the references section contains pointers to resources that prove the statements of the document.
Often these proofs are not easily distinguishable from further information. In this case you may want to skip the reference section in favour for the resource list.
Resources
The resources section provides references to further information to the topic of the document.
This may be information on the internet provided by the resource or information in the team's information systems. Anything the reader of the resource might want to know, may be listed here.
Details
Resource Type Macro
The Resource Type Macro provides a simplified version for pattern domains where a value may be selected from a fixed set of values.
Resources
- Resource Types - examples of document instances for use in your project.
