glam/schemas/20251121/linkml/modules/classes/MissionStatement.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

161 lines
8.3 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
- ../classes/Policy
- ../enums/StatementTypeEnum
- ../slots/content_hash
- ../slots/css_selector
- ../slots/describes_or_described
- ../slots/has_or_had_identifier
- ../slots/has_or_had_language
- ../slots/has_or_had_note
- ../slots/has_or_had_provenance_path
- ../slots/has_or_had_score
- ../slots/has_or_had_summary
- ../slots/has_or_had_text
- ../slots/has_or_had_type
- ../slots/has_or_had_url
- ../slots/is_or_was_effective_at
- ../slots/page_section
- ../slots/retrieved_on
- ../slots/source_url
- ../slots/specificity_annotation
- ../slots/supersedes_or_superseded
- ../slots/temporal_extent
- ./SpecificityAnnotation
- ./StatementType
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./URL
- ./XPath
- ./Policy
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\nOrganizations revise their mission statements over time.\n\
The `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 - has_or_had_text: \"Waar komt ons voedsel \xE9cht 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 - has_or_had_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:
- describes_or_described
- content_hash
- css_selector
- is_or_was_effective_at
- has_or_had_note
- temporal_extent
- page_section
- retrieved_on
- source_url
- specificity_annotation
- has_or_had_identifier
- has_or_had_language
- has_or_had_summary
- has_or_had_text
- has_or_had_type
- supersedes_or_superseded
- has_or_had_score
- has_or_had_url
- has_or_had_provenance_path
slot_usage:
describes_or_described:
range: string
has_or_had_type:
required: true
range: StatementType
examples:
- value: mission
- value: vision
- value: goal
has_or_had_text:
required: true
source_url:
required: true
retrieved_on:
required: true
has_or_had_provenance_path:
range: XPath
inlined: true
has_or_had_url:
range: uri
inlined: true
examples:
- value:
url_value: https://example.org/about#:~:text=Our%20mission%20is
url_type: text_fragment
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
- has_or_had_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:
has_or_had_identifier: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/mission-2025
has_or_had_type: mission
has_or_had_text: "Waar komt ons voedsel \xE9cht vandaan."
has_or_had_language: nl
has_or_had_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...
has_or_had_score:
has_or_had_score: 0.95
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/vision-2025
has_or_had_type: vision
has_or_had_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.
'
has_or_had_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...
has_or_had_score:
has_or_had_score: 0.9
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/goals-2025
has_or_had_type: goal
has_or_had_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"
has_or_had_language: nl
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Doelstellingen
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"