Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Document Properties Marker
overridefalse
Short DescriptionInformation for managing systems. 
Doctypecategoryhide
Short NameSystemhide
Name
Parent Property
add-linkfalse
property-nameName
/
Display Property
property-nameShort Name
 
Parent
Parent Property
propertyParent
property-nameName
 
Audience
Name List
doctyperole
propertyAudience
hide
Categories
Name List
doctypecategory
propertyCategories
 
Tags
Tag List
propertyTags
 
Iteration

Iteration
valuefilled

hide
Sort Keyhide
CSS Style Informationhide
Section
titleDescription

The doctypes listed here are related to documenting environments, nodes, and deployed artifacts in an UML style.

Note Box
titleAdding Properties

These doctypes may miss some properties that are relevant for actual system management tasks. We are working on doctypes that are dealing with system management use cases, but these templates are still under development.

If you want to add specific properties, you may add them to the doctypes listed here or clone them.

Please keep in mind that ancestor queries (i.e. searching in the hierarchy of a given document property) is only supported for blueprints (i.e. not in templates edited via the Confluence UI). So you need to clone the project projectdoc Doctypes for Software Development on Bitbucket to support these kind of queries.

Section
titleSubordinate Categories
Display Table
doctypecategory
render-no-hits-as-blanktrue
selectShort Name+, Short Description
restrict-to-immediate-childrentrue
sort-bySort Key, Name
Section
titleDocuments

Documents associated with this or one of the subcategories.

Display Table
render-no-hits-as-blanktrue
selectName, Short Description
where$<Categories> = °${Name}°

Section
titleTips on using Doctypes

Each system element can be associated with type specific information. Types help to categorize and organize environments, nodes, and artifacts. Documentation Architects are free to design an information architecture that fits their needs since there are little or no constraints on the element and type doctypes.

One approach could be to have artifact types that document the form of the artifact. For instance JAR, ZIP, or XML file. These artifacts are then associated with nodes. You may define node types to model the operating systems you use. For instance one path in this hierarchy could be

Code Block
languagetext
> Operating System > Linux > Red Hat Linux > Red Hat Linux 7.2

Nodes are then associated with "Red Hat Linux 7.2".

The physical nodes are then associated with physical environments. Logical information that applies to each physical environment is then documented with an environment type.

Section
required-permissionswrite-access
titleNotes

Section
titleReferences

Section
titleResources