iso27diy-corp/metadata/corpus-metadata.md

2.6 KiB

Corpus Metadata

  • All notes in this Obsidian vault need metadata.
  • These metadata need to follow the obsidian-front-matter-syntax.
  • Obsidian calls metadata variables 'Properties'
  • In this Corpus we use General properties (every note should have them) and Specific properties (depending on the kind of note, can be inferred from other properties)

General metadata

Notetype

The notetype field will have one of the following values:

  • guide: guided, hands-on lessons, learning by doing, interactive lessons
  • explanation: background and context to the standards, paraphrases of the original standard texts, opinion, discussion, underlying principles, interpretation
  • application: steps to solve a specific, real-world problem. Implementing the standard in real world environments, implementation aids, implementation examples, templates, etc.
  • reference: for original standard texts, dictionaries, terms and definitions.
  • other: for all notes that, by there content, cannot be placed in one for the previous categories.

Note:

  • Notes in the iso27DIY-gis/guide folder and subfolders are typically of the guide type.
  • Notes in iso27DIY-gis/reference and subfolders are typically of the explanation or application type.

Language

For the language property we use the language code as defined in ISO 639-1.

Status

As of yet, the only value defined for the status property is active.

Isotags

The property isotags, of type list, allows any note to be linked to clauses and controls of the ISO 27001 / ISO 27002 standard, by the id property of the Original Standard Texts, found in Corpus/Standards/ISO27x/OST/27001/EN and /Corpus/Standards/ISO27x/OST/27002/EN, respectively. For example, a note that needs to be linked to ISO 27001 clause 5.2 Policy, will get a value of C.5.2 added to its isotags list. Likewise, a note that needs to be linked to ISO 27002 control 5.15 Access control, will get a value of A.5.15 added to its isotags list.

Metadata for ISO 27001 and 27002 Original Standard Texts

  • The original texts of the ISO 27001 and ISO 27002 standards can be found in the OST folder and subfolders.
  • These notes are tagged with “sourcetext”.
  • The body of these notes must never be changed!
  • Specific properties for ISO 27002 OST notes are deduced from chapter 4 of the standard ("Themes and Attributes"). They are: theme, control_type, information_security_properties, cybersecurity_concepts, operational_capabilities, and security_domains.
  • For the possible values of these properties, see themes-and-attributes-in-iso-27002.