glam/schemas/20251121/linkml/modules/classes/MissionStatement.yaml
kempersc 4319f38c05 Add archived slots for audience size, audience type, and capacity metrics
- Created new YAML files for audience size and audience type slots, defining their properties and annotations.
- Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges.
- Introduced a template specificity slot for context-aware RAG filtering.
- Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
2026-01-17 18:53:23 +01:00

209 lines
10 KiB
YAML

id: https://nde.nl/ontology/hc/class/MissionStatement
name: MissionStatement
title: MissionStatement Class - Organizational Purpose Documentation
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
pav: http://purl.org/pav/
org: http://www.w3.org/ns/org#
xsd: http://www.w3.org/2001/XMLSchema#
oa: http://www.w3.org/ns/oa#
imports:
- linkml:types
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../enums/StatementTypeEnum
- ./StatementType
- ./XPath
- ../slots/source_url
- ../slots/retrieved_on
- ../slots/content_hash
- ../slots/supersedes_or_superseded # was: supersede - migrated per Rule 53/56 (2026-01-17)
- ../slots/effective_date
- ../slots/extraction_agent
- ../slots/extraction_note
- ../slots/has_or_had_provenance_path
- ../slots/css_selector
- ../slots/html_file
- ../slots/extraction_timestamp
- ../slots/extraction_confidence
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ../slots/statement_id
- ../slots/has_or_had_type
- ../slots/statement_text
- ../slots/statement_language
- ../slots/statement_summary
- ../slots/page_section
- ../slots/has_or_had_url # was: text_fragment - migrated per Rule 53
- ./URL # for has_or_had_url range (Rule 53 migration)
- ../slots/has_archive_memento_uri
- ../slots/has_adoption_context
default_prefix: hc
classes:
MissionStatement:
class_uri: org:purpose
description: "A structured record of an organizational purpose statement (mission, vision,\ngoals, values, or motto) extracted\
\ from a heritage custodian's website with\nfull provenance documentation.\n\n**PURPOSE**:\n\nHeritage custodians publish\
\ mission and vision statements that articulate:\n- Why they exist (mission)\n- What future state they aspire to (vision)\n\
- What specific outcomes they pursue (goals)\n- What principles guide their work (values)\n- Memorable phrases encapsulating\
\ their purpose (mottos)\n\nThese statements are valuable for:\n- Understanding organizational identity and purpose\n\
- Comparing institutions within and across sectors\n- Tracking organizational evolution over time\n- Research on heritage\
\ sector discourse and priorities\n\n**PROVENANCE REQUIREMENTS**:\n\nFollowing the WebObservation pattern, every MissionStatement\
\ MUST have:\n\n1. **Source documentation**: source_url + retrieved_on\n2. **Location evidence**: xpath OR css_selector\
\ + html_file\n3. **Integrity verification**: content_hash (SHA-256)\n4. **Archive link**: has_archive_memento_uri (recommended)\n\
\nStatements without verifiable provenance are rejected.\n\n**ONTOLOGY ALIGNMENT**:\n\nW3C Organization Ontology `org:purpose`:\n\
- \"Indicates the purpose of this Organization\"\n- \"There can be many purposes at different levels of abstraction\"\
\n- \"It is recommended that the purpose be denoted by a controlled term\"\n\nWe extend this by:\n- Distinguishing statement\
\ types (mission, vision, goal, value, motto)\n- Adding temporal tracking (effective_date, supersedes)\n- Full provenance\
\ chain (source_url, xpath, content_hash, archive)\n\n**MULTILINGUAL SUPPORT**:\n\nHeritage custodians publish statements\
\ in their native language.\nFor Dutch institutions, statements are typically in Dutch.\nThe statement_language field\
\ captures the ISO 639-1 code,\nand statement_summary can provide English translation.\n\n**TEMPORAL TRACKING**:\n\n\
Organizations revise their mission statements over time.\nThe `supersedes` field links to previous statements,\nenabling\
\ tracking of how organizational purpose evolves.\n\n**EXAMPLES**:\n\n1. **Dutch Agricultural Museum Mission**\n -\
\ statement_type: mission\n - statement_text: \"Waar komt ons voedsel écht vandaan.\"\n - statement_language: nl\n\
\ - source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie\n \n2. **Rijksmuseum Vision**\n\
\ - statement_type: vision\n - statement_text: \"Het Rijksmuseum verbindt mensen met kunst en geschiedenis.\"\n\
\ - statement_language: nl\n - statement_summary: \"The Rijksmuseum connects people with art and history.\"\n"
exact_mappings:
- org:purpose
close_mappings:
- schema:description
- prov:Entity
related_mappings:
- schema:slogan
- schema:ethicsPolicy
- schema:seeks
slots:
- has_adoption_context
- has_archive_memento_uri
- content_hash
- css_selector
- effective_date
- extraction_agent
- extraction_confidence
- extraction_note
- extraction_timestamp
- html_file
- page_section
- retrieved_on
- source_url
- specificity_annotation
- statement_id
- statement_language
- statement_summary
- statement_text
- has_or_had_type
- supersedes_or_superseded # was: supersede - migrated per Rule 53/56 (2026-01-17)
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- has_or_had_url # was: text_fragment - migrated per Rule 53
- has_or_had_provenance_path
slot_usage:
has_or_had_type:
required: true
range: StatementType
description: |
The type of organizational purpose statement.
Uses StatementType class hierarchy (mission, vision, goal, value, motto).
examples:
- value: mission
description: Mission statement
- value: vision
description: Vision statement
- value: goal
description: Goals/objectives statement
statement_text:
required: true
source_url:
required: true
retrieved_on:
required: true
has_or_had_provenance_path:
range: XPath
inlined: true
description: |
XPath provenance path documenting the exact location in the source HTML
where this statement was extracted from. Contains the XPath expression,
match score, and reference to the archived HTML file.
has_or_had_url: # was: text_fragment - migrated per Rule 53
range: URL
inlined: true
description: |
W3C Text Fragment URL enabling direct deep-linking to the statement.
Format: {source_url}#:~:text={encoded_text}
MIGRATED 2026-01-15: Uses URL class with url_type="text_fragment"
per slot_fixes.yaml Rule 53 migration.
examples:
- value:
url_value: "https://example.org/about#:~:text=Our%20mission%20is"
url_type: text_fragment
description: W3C Text Fragment URL for direct linking
comments:
- 'MIGRATION (2026-01-15): Replaced xpath/xpath_match_score slots with has_or_had_provenance_path using XPath class per slot_fixes.yaml'
- 'MIGRATION (2026-01-15): Replaced text_fragment slot with has_or_had_url using URL class (url_type=text_fragment) per slot_fixes.yaml'
- 'Rule note: Mottos should be brief - typically under 50 characters'
- MissionStatement maps to org:purpose from W3C Organization Ontology
- Requires source_url and retrieved_on for provenance
- Strongly recommend has_or_had_provenance_path (XPath class) + html_file for verification
- content_hash enables integrity checking
- has_archive_memento_uri ensures long-term source accessibility
- Supports tracking statement evolution via supersedes field
- statement_language uses ISO 639-1 codes (nl, en, de, etc.)
see_also:
- https://www.w3.org/TR/vocab-org/#org:purpose
- https://www.w3.org/TR/prov-o/
- https://wicg.github.io/scroll-to-text-fragment/
- https://www.w3.org/TR/SRI/
examples:
- value:
statement_id: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/mission-2025
has_or_had_type: mission
statement_text: Waar komt ons voedsel écht vandaan.
statement_language: nl
statement_summary: Where does our food really come from.
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Onze Missie
content_hash: sha256-abc123...
extraction_agent: claude-opus-4.5
extraction_confidence: 0.95
description: Mission statement from Dutch agricultural museum
- value:
statement_id: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/vision-2025
has_or_had_type: vision
statement_text: 'Het Landbouwmuseum Tiengemeten voelt zich onderdeel van een belangrijke
agrarische ontwikkeling, de mechanisatie tussen 1920 en 1955. De collectie
is relevant en de presentatie verbindt generaties.
'
statement_language: nl
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Onze visie
content_hash: sha256-def456...
extraction_agent: claude-opus-4.5
extraction_confidence: 0.9
description: Vision statement from Dutch agricultural museum
- value:
statement_id: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/goals-2025
has_or_had_type: goal
statement_text: "Onze ambitie en doelstellingen hebben wij geformuleerd rondom de volgende punten:\n- Het Landbouwmuseum\
\ Tiengemeten laat de ontwikkeling van het boerenbedrijf\n in de periode 1920 tot 1955 zien d.m.v. een prachtige\
\ collectie.\n- Voor onze bezoekers een gewaardeerd en gastvrij museum te zijn.\n- De collecties welke wij beheren\
\ toegankelijk maken voor nu en voor\n volgende generaties.\n"
statement_language: nl
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Doelstellingen
extraction_agent: claude-opus-4.5
description: Goals/objectives from Dutch agricultural museum