Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Document Properties Marker
overridefalse
Short DescriptionIf a doctype relies on defaults, the declaration is quite shortAn example of a simple type-like doctype.
Doctypesectionhide
NameDiscoverybility Examplehide
Short Name
Parent
Parent Property
property-nameName

Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
propertyCategories

Tags

Tag List
namesexample
propertyTags

hide
Iteration

Iteration
valuefinished

hide
Sort Key000010hide
Section
show-titlefalse
titleDescription

Doctypes that are type-like are used to categorize other doctypes without being closely related to this type.

projectdoc-box-example

Consider a resource doctype that describes resources like books or videocasts. A type for this doctype would be called resource type. Values for this type would book or videocast. The document instances (book and videocast would list all resources of their type automatically.

A type-like doctype has the same function as the resource type. It creates an additional dimension and may be used by more than one doctype. One example for such a type-like doctype is experience level. Again, instances of this doctype will list all resources (or document of other types that also provide this property) associated with this particular experience level (e.g. novice or expert).

projectdoc-section
titleSummary

Section
titleExample

The example provides labels and texts and a list of related doctypes. Since this doctype relies on defaults, the declaration is quite short.

Code Block
languagexml
<?xml version='1.0'?>

<doctype
  xmlns="http://smartics.de/xsd/projectdoc/doctype/1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  id="discoverability"
  base-template="type"
  provide-type="none"
  category="threat-characteristic">
  <resource-bundle>
    <l7n>
      <name plural="Discoverabilities">Discoverability</name>
      <description>
        The assumed chance that the security vulnerability can be exploited.
      </description>
      <about>
        Document the chance that a possible threat can be discovered.
      </about>
    </l7n>
    <l7n locale="de">
      <name plural="Entdeckbarkeiten">Entdeckbarkeit</name>
      <description>
        Die angenommene Chance, dass die Sicherheitslücke für einen Angriff
        entdeckt werden kann.
      </description>
      <about>
        Dokumentieren Sie die Wahrscheinlichkeit, dass eine Sicherheitslücke
        entdeckt werden kann.
      </about>
    </l7n>
  </resource-bundle>

  <related-doctypes>
    <id>affected-users</id>
    <id>damage-potential</id>
    <id>exploitability</id>
    <id>mitigation-level</id>
    <id>reproducibility</id>
    <id>threat-category</id>
    <id>threat-type</id>
  </related-doctypes>
</doctype>

The related doctypes are used to render links from the doctype's home and index page.

...