Policy

PartDraftv1.0.0-rc.2

A policy: one risk that a framework manages, and the criteria that manage it.

https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Policy.json

Fields

  • id
    textnot empty

    The record's id: unique within the document.

  • nameRequired
    text

    The name people use for the record.

  • description
    text

    What the record is, in words.

  • citation
    DatatypeCitation

    The part of the published framework that sets the policy.

  • type
    One ofthe codes below

    What the policy rests on.

    objective
    Facts that can be observed and checked, such as a legal limit.
    intersubjective
    Agreements, norms or conventions that a group shares.
    subjective
    A judgement or a point of view.
  • criteria
    List ofPartCriterion

    The criteria that manage the risk.

Links

Holds Parts this record embeds, with the field that holds each.

Held by Records that embed this one, with their field that holds it.

Examples

An id that another example defines opens that record.

Example 2

{
  "id": "policy-noise",
  "name": "Noise at dwellings",
  "type": "objective",
  "criteria": [
    {
      "id": "criterion-1",
      "name": "Night-time permissible sound level"
    }
  ]
}
Show 1 more example

Example 1

{
  "id": "policy-1",
  "name": "Noise at dwellings"
}

Changes and file

Changes

  1. 0.1.0 First version.

Schema file

Show the JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Policy.json",
  "title": "Policy",
  "description": "A policy: one risk that a framework manages, and the criteria that manage it.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The record's id: unique within the document."
    },
    "name": {
      "type": "string",
      "description": "The name people use for the record."
    },
    "description": {
      "type": "string",
      "description": "What the record is, in words."
    },
    "citation": {
      "$ref": "Citation.json",
      "description": "The part of the published framework that sets the policy."
    },
    "type": {
      "type": "string",
      "enum": [
        "objective",
        "intersubjective",
        "subjective"
      ],
      "description": "What the policy rests on.",
      "x-ods-options": [
        {
          "value": "objective",
          "title": "Objective",
          "description": "Facts that can be observed and checked, such as a legal limit."
        },
        {
          "value": "intersubjective",
          "title": "Intersubjective",
          "description": "Agreements, norms or conventions that a group shares."
        },
        {
          "value": "subjective",
          "title": "Subjective",
          "description": "A judgement or a point of view."
        }
      ]
    },
    "criteria": {
      "type": "array",
      "items": {
        "$ref": "Criterion.json"
      },
      "description": "The criteria that manage the risk."
    }
  },
  "required": [
    "name"
  ],
  "patternProperties": {
    "^x-": {}
  },
  "unevaluatedProperties": false,
  "examples": [
    {
      "id": "policy-1",
      "name": "Noise at dwellings"
    },
    {
      "id": "policy-noise",
      "name": "Noise at dwellings",
      "type": "objective",
      "criteria": [
        {
          "id": "criterion-1",
          "name": "Night-time permissible sound level"
        }
      ]
    }
  ],
  "x-ods-status": "draft",
  "x-ods-kind": "part",
  "x-ods-module": "core",
  "x-ods-changes": {
    "0.1.0": "First version."
  }
}