glam/frontend/public/schemas/20251121/linkml/rules/README.md

Value Standardization Rules

Location: schemas/20251121/linkml/rules/
Purpose: Data transformation and processing rules for achieving standardized values required by Heritage Custodian (HC) classes.

---

About These Rules

These rules are formally outside the LinkML schema convention but document HOW data values are:

• Transformed
• Converted
• Processed
• Normalized

to achieve the standardized values required by particular HC classes.

IMPORTANT: These are NOT LinkML validation rules. They are processing instructions for data pipelines and extraction agents.

---

Rule Categories

1. Name Standardization Rules

Rule ID	File	Applies To	Summary
LEGAL-FORM-FILTER	LEGAL_FORM_FILTER.md	CustodianName	Remove legal form terms (Stichting, Foundation, Inc.) from emic names
ABBREV-CHAR-FILTER	ABBREVIATION_RULES.md	GHCID abbreviation	Remove special characters (&, /, +, @) and normalize diacritics to ASCII
TRANSLIT-ISO	TRANSLITERATION.md	GHCID abbreviation	Transliterate non-Latin scripts (Cyrillic, CJK, Arabic) using ISO standards

2. Geographic Standardization Rules

Rule ID	File	Applies To	Summary
GEONAMES-SETTLEMENT	GEONAMES_SETTLEMENT.md	Settlement codes	Use GeoNames as single source for settlement names
FEATURE-CODE-FILTER	GEONAMES_SETTLEMENT.md	Reverse geocoding	Only use PPL* feature codes, never PPLX (neighborhoods)

3. Web Observation Rules

Rule ID	File	Applies To	Summary
XPATH-PROVENANCE	XPATH_PROVENANCE.md	WebClaim	Every web claim MUST have XPath pointer to archived HTML

4. Schema Evolution Rules

Rule ID	File	Applies To	Summary
ENUM-TO-CLASS	ENUM_TO_CLASS.md	Enums/Classes	When enum promoted to class hierarchy, delete original enum

---

GLAMORCUBESFIXPHDNT Taxonomy Applicability

Each rule primarily applies to certain custodian types:

Rule	Primary Types	All Types
LEGAL-FORM-FILTER	All	✅
ABBREV-SPECIAL-CHAR	All	✅
ABBREV-DIACRITICS	All	✅
TRANSLITERATION	International (non-Latin script countries)	Partial
GEONAMES-SETTLEMENT	All	✅
XPATH-PROVENANCE	D (Digital platforms)	Partial

---

Integration with bronhouder.nl

These rules are displayed under a separate "Regels" (Rules) category on the bronhouder.nl LinkML visualization page, distinct from:

• Classes
• Slots
• Enums
• Instances

Each rule includes:

• Rule ID (short identifier)
• Applicable class(es)
• GLAMORCUBESFIXPHDNT type indicator
• Transformation examples
• Implementation code (Python)

---

Rule Template

New rules should follow this template:

# Rule Title

**Rule ID**: SHORT-ID  
**Status**: MANDATORY | RECOMMENDED | OPTIONAL  
**Applies To**: Class or slot name  
**Created**: YYYY-MM-DD  
**Updated**: YYYY-MM-DD

---

## Summary

One-paragraph summary of what this rule does.

---

## Rationale

Why this rule exists (numbered list of reasons).

---

## Specification

Detailed specification with examples.

---

## Implementation

Python code showing how to implement this rule.

---

## Examples

| Input | Output | Explanation |
|-------|--------|-------------|

---

## Related Rules

- Other related rules

---

## Changelog

| Date | Change |
|------|--------|

---

File List

rules/
├── README.md                  # This file (rule index)
├── ABBREVIATION_RULES.md      # ABBREV-CHAR-FILTER: Special char + diacritics normalization
├── LEGAL_FORM_FILTER.md       # LEGAL-FORM-FILTER: Legal form removal from emic names
├── GEONAMES_SETTLEMENT.md     # GEONAMES-SETTLEMENT: Geographic standardization via GeoNames
├── XPATH_PROVENANCE.md        # XPATH-PROVENANCE: WebClaim XPath requirements
├── TRANSLITERATION.md         # TRANSLIT-ISO: Non-Latin script transliteration
└── ENUM_TO_CLASS.md           # ENUM-TO-CLASS: Schema evolution pattern