diff --git a/.opencode/rules/class-description-quality-rule.md b/.opencode/rules/class-description-quality-rule.md index f44ed5da05..3b2a8d027e 100644 --- a/.opencode/rules/class-description-quality-rule.md +++ b/.opencode/rules/class-description-quality-rule.md @@ -2,7 +2,7 @@ ## Rule: Write Dictionary-Style Definitions Without Repeating the Class Name -When writing class descriptions, follow these principles: +When writing class descriptions, follow these principles. ### 1. No Repetition of Class Name Components @@ -25,13 +25,70 @@ AcademicArchiveRecordSetType: The description should define the concept using synonyms and related terms, not repeat words from the class name. -### 2. No Structured Data or Meta-Discussion in Descriptions +### 2. MIGRATE Structured Data Before Removing from Descriptions -Descriptions should contain only the definition. Do not include: +**CRITICAL**: When a description contains structured data (examples, typical contents, alignment notes, etc.), you MUST: + +1. **First check** if the structured data already exists in proper LinkML fields +2. **If NOT present**: ADD it to the appropriate structured field +3. **ONLY THEN**: Remove it from the description + +**Never simply delete structured content from descriptions without preserving it elsewhere.** + +**MIGRATION CHECKLIST:** + +| Content Type | Target Field | Example | +|--------------|--------------|---------| +| Example instances | `examples:` | `- value: {...} description: "..."` | +| Typical contents | `keywords:` or `comments:` | List of typical materials | +| Alignment explanations | `broad_mappings`, `related_mappings` | Ontology references | +| Usage notes | `comments:` | Operational guidance | +| Provenance notes | `comments:` or `annotations:` | Historical context | +| Privacy/legal notes | `comments:` | Access restrictions | +| Definition details | Keep in description | Core semantic definition | + +**WRONG - Deleting without migration:** +```yaml +# BEFORE (has rich content) +description: | + Records documenting student academic careers. + + **Typical Contents**: + - Enrollment records + - Academic transcripts + - Graduation records + + Subject to privacy regulations (FERPA, GDPR). + +# AFTER (lost information!) - DON'T DO THIS +description: >- + Records documenting student academic careers. +``` + +**CORRECT - Migrate first, then clean:** +```yaml +# Step 1: Add to structured fields +description: >- + Records documenting student academic careers. +keywords: + - enrollment records + - academic transcripts + - graduation records +comments: + - Subject to privacy regulations (FERPA, GDPR, AVG) + - Access restrictions typically apply for records less than 75 years old + +# Step 2: Now description is clean but no information lost +``` + +### 3. No Structured Data or Meta-Discussion in Descriptions + +After migration, descriptions should contain only the definition. Do not include: - Alignment explanations (use `broad_mappings`, `close_mappings`, `exact_mappings`) - Pattern explanations (use `see_also`, `comments`) - Usage examples (use `examples:` annotation) - Rationale for mappings (use `comments:` or `annotations:`) +- Typical contents lists (use `keywords:` or `comments:`) **WRONG:** ```yaml @@ -55,12 +112,15 @@ broad_mappings: - rico:RecordSetType see_also: - AcademicArchive +keywords: + - administrative fonds + - student records examples: - value: {...} description: Administrative fonds containing governance records ``` -### 3. Use Folded Block Scalar (`>-`) for Descriptions +### 4. Use Folded Block Scalar (`>-`) for Descriptions Use `>-` (folded, strip) instead of `|` (literal) to ensure clean paragraph formatting in generated documentation. @@ -78,7 +138,7 @@ description: >- in the generated documentation. ``` -### 4. Use LinkML `examples:` Annotation for Examples +### 5. Use LinkML `examples:` Annotation for Examples Structure examples properly with `value:` and `description:` keys. @@ -90,6 +150,71 @@ examples: description: Administrative fonds containing governance records ``` +### 6. Keywords vs Examples - Know the Difference + +**CRITICAL**: Do not confuse `keywords:` with `examples:`. They serve different purposes: + +| Field | Purpose | Content Type | +|-------|---------|--------------| +| `keywords:` | Search terms, topics, categories | List of strings (topics/materials) | +| `examples:` | Valid instance data demonstrations | Structured objects with `value` and `description` | + +**Keywords** = Topics, material types, categories that describe what the class is about: +```yaml +keywords: + - enrollment records # type of material + - academic transcripts # type of material + - graduation records # type of material +``` + +**Examples** = Actual instances of the class with populated slots: +```yaml +examples: +- value: + has_type: hc:ArchiveOrganizationType + has_label: Registrar Student Records + has_note: Enrollment, transcripts, graduation records + description: Student records series from the registrar's office +``` + +**WRONG - Using keywords as examples:** +```yaml +# DON'T: "enrollment records" is not an instance of AcademicStudentRecordSeries +examples: +- value: enrollment records + description: Type of student record +``` + +**CORRECT - Keywords for topics, examples for instances:** +```yaml +keywords: + - enrollment records + - academic transcripts + - graduation records +examples: +- value: + has_type: hc:ArchiveOrganizationType + has_label: Historical Student Records + has_note: Pre-1950 student records with fewer access restrictions + description: Historical student records open for research access +``` + +### 7. Multiple Examples for Different Use Cases + +Provide multiple examples to show different contexts or configurations: + +```yaml +examples: +- value: + has_type: hc:ArchiveOrganizationType + has_label: Recent Student Records + description: Current records subject to privacy restrictions +- value: + has_type: hc:ArchiveOrganizationType + has_label: Historical Student Records + description: Records 75+ years old with fewer access restrictions +``` + ## Summary | Element | Placement | @@ -100,3 +225,4 @@ examples: | Usage notes | `comments:` | | Metadata | `annotations:` | | Examples | `examples:` with `value` and `description` | +| Typical contents | `keywords:` or `comments:` | diff --git a/.opencode/rules/class-multilingual-support-rule.md b/.opencode/rules/class-multilingual-support-rule.md new file mode 100644 index 0000000000..1b5e893bf6 --- /dev/null +++ b/.opencode/rules/class-multilingual-support-rule.md @@ -0,0 +1,158 @@ +# Class Multilingual Support Rule + +## Rule: All Class Files Must Include Multilingual Descriptions and Aliases + +Every class file must provide `alt_descriptions` and `structured_aliases` in all supported languages to ensure internationalization and interoperability with multilingual heritage systems. + +### Required Languages + +| Code | Language | +|------|----------| +| `nl` | Dutch | +| `de` | German | +| `fr` | French | +| `es` | Spanish | +| `ar` | Arabic | +| `id` | Indonesian | +| `zh` | Chinese | + +### Structure + +#### alt_descriptions + +Provide translated descriptions for each supported language: + +```yaml +classes: + AcademicArchiveRecordSetType: + description: >- + Category for grouping documentary materials accumulated by tertiary + educational institutions during their administrative, academic, and + operational activities. + alt_descriptions: + nl: >- + Categorie voor het groeperen van documentair materiaal dat door + hogeronderwijsinstellingen is verzameld tijdens hun administratieve, + academische en operationele activiteiten. + de: >- + Kategorie zur Gruppierung von Dokumentenmaterial, das von Hochschulen + während ihrer administrativen, akademischen und betrieblichen Aktivitäten + angesammelt wurde. + fr: >- + Catégorie de regroupement des documents accumulés par les établissements + d'enseignement supérieur au cours de leurs activités administratives, + académiques et opérationnelles. + es: >- + Categoría para agrupar materiales documentales acumulados por instituciones + de educación superior durante sus actividades administrativas, académicas + y operativas. + ar: >- + فئة لتجميع المواد الوثائقية التي جمعتها مؤسسات التعليم العالي + خلال أنشطتها الإدارية والأكاديمية والتشغيلية. + id: >- + Kategori untuk mengelompokkan materi dokumenter yang dikumpulkan oleh + institusi pendidikan tinggi selama aktivitas administratif, akademik, + dan operasional mereka. + zh: >- + 高等教育机构在行政、学术和运营活动中积累的文献材料的分类类别。 +``` + +#### structured_aliases + +Provide language-specific aliases/alternative names: + +```yaml +classes: + AcademicArchiveRecordSetType: + structured_aliases: + - literal_form: academisch archiefbestand + in_language: nl + - literal_form: Hochschularchivbestand + in_language: de + - literal_form: fonds d'archives académiques + in_language: fr + - literal_form: fondo de archivo académico + in_language: es + - literal_form: أرشيف أكاديمي + in_language: ar + - literal_form: koleksi arsip akademik + in_language: id + - literal_form: 学术档案集 + in_language: zh +``` + +### Complete Example + +```yaml +id: https://nde.nl/ontology/hc/class/AcademicArchiveRecordSetType +name: AcademicArchiveRecordSetType +title: Academic Archive Record Set Type +prefixes: + linkml: https://w3id.org/linkml/ + hc: https://nde.nl/ontology/hc/ + skos: http://www.w3.org/2004/02/skos/core# +default_prefix: hc +imports: + - linkml:types + - ../classes/CollectionType +classes: + AcademicArchiveRecordSetType: + description: >- + Category for grouping documentary materials accumulated by tertiary + educational institutions during their administrative, academic, and + operational activities. + alt_descriptions: + nl: >- + Categorie voor het groeperen van documentair materiaal dat door + hogeronderwijsinstellingen is verzameld. + de: >- + Kategorie zur Gruppierung von Dokumentenmaterial, das von Hochschulen + angesammelt wurde. + fr: >- + Catégorie de regroupement des documents accumulés par les établissements + d'enseignement supérieur. + es: >- + Categoría para agrupar materiales documentales acumulados por instituciones + de educación superior. + ar: >- + فئة لتجميع المواد الوثائقية التي جمعتها مؤسسات التعليم العالي. + id: >- + Kategori untuk mengelompokkan materi dokumenter yang dikumpulkan oleh + institusi pendidikan tinggi. + zh: >- + 高等教育机构积累的文献材料的分类类别。 + structured_aliases: + - literal_form: academisch archiefbestand + in_language: nl + - literal_form: Hochschularchivbestand + in_language: de + - literal_form: fonds d'archives académiques + in_language: fr + - literal_form: fondo de archivo académico + in_language: es + - literal_form: أرشيف أكاديمي + in_language: ar + - literal_form: koleksi arsip akademik + in_language: id + - literal_form: 学术档案集 + in_language: zh + is_a: CollectionType + # ... rest of class definition +``` + +### Translation Guidelines + +1. **Accuracy over literal translation**: Translate the concept, not word-by-word +2. **Use domain-appropriate terminology**: Use archival/library/museum terminology standard in each language +3. **Consult existing vocabularies**: Reference RiC-O, ISAD(G), AAT translations when available +4. **Maintain consistency**: Same term should be translated consistently across all class files + +### Checklist + +For each class file, verify: + +- [ ] `alt_descriptions` present with all 7 languages +- [ ] `structured_aliases` present with all 7 languages +- [ ] Translations are accurate and domain-appropriate +- [ ] Arabic text is properly encoded (RTL) +- [ ] Chinese uses simplified characters (zh) unless traditional specified (zh-hant) diff --git a/frontend/public/schemas/20251121/linkml/manifest.json b/frontend/public/schemas/20251121/linkml/manifest.json index 021a846ce7..5a25130f6d 100644 --- a/frontend/public/schemas/20251121/linkml/manifest.json +++ b/frontend/public/schemas/20251121/linkml/manifest.json @@ -1,5 +1,5 @@ { - "generated": "2026-02-14T13:41:49.801Z", + "generated": "2026-02-14T19:11:47.040Z", "schemaRoot": "/schemas/20251121/linkml", "totalFiles": 2369, "categoryCounts": { diff --git a/schemas/20251121/linkml/manifest.json b/schemas/20251121/linkml/manifest.json index 5a25130f6d..2023f5a752 100644 --- a/schemas/20251121/linkml/manifest.json +++ b/schemas/20251121/linkml/manifest.json @@ -1,5 +1,5 @@ { - "generated": "2026-02-14T19:11:47.040Z", + "generated": "2026-02-14T21:22:57.846Z", "schemaRoot": "/schemas/20251121/linkml", "totalFiles": 2369, "categoryCounts": { diff --git a/schemas/20251121/linkml/modules/classes/AcademicArchive.yaml b/schemas/20251121/linkml/modules/classes/AcademicArchive.yaml index 7974cf06cd..6429d647e1 100644 --- a/schemas/20251121/linkml/modules/classes/AcademicArchive.yaml +++ b/schemas/20251121/linkml/modules/classes/AcademicArchive.yaml @@ -1,53 +1,120 @@ id: https://nde.nl/ontology/hc/class/AcademicArchive name: AcademicArchive -title: Academic Archive Type +title: Academic Archive prefixes: linkml: https://w3id.org/linkml/ + hc: https://nde.nl/ontology/hc/ schema: http://schema.org/ skos: http://www.w3.org/2004/02/skos/core# rico: https://www.ica.org/standards/RiC/ontology# wd: http://www.wikidata.org/entity/ +default_prefix: hc imports: - linkml:types + - ../classes/ArchiveOrganizationType + - ../classes/WikidataAlignment - ../slots/has_hypernym - - ../slots/identified_by - ../slots/has_label - - ../slots/has_scope - ../slots/has_score - ../slots/has_type - ../slots/hold_record_set + - ../slots/identified_by - ../slots/related_to classes: AcademicArchive: + description: >- + Organizational unit serving as the official custodian for the documentary + heritage of a tertiary educational institution. Charged with acquiring, + preserving, and providing access to administrative records, faculty papers, + student records, and campus documentation. Distinguished from institutional + repositories that primarily manage published scholarly outputs. + alt_descriptions: + nl: >- + Organisatorische eenheid die fungeert als de officiële bewaarder van het + documentair erfgoed van een instelling voor hoger onderwijs. Belast met het + verwerven, bewaren en toegankelijk maken van administratieve archieven, + archieven van hoogleraren, studentendossiers en campusdocumentatie. Te + onderscheiden van institutionele repositories die voornamelijk gepubliceerde + wetenschappelijke output beheren. + de: >- + Organisatorische Einheit, die als offizieller Verwahrer des dokumentarischen + Erbes einer Hochschuleinrichtung dient. Zuständig für Erwerbung, Erhaltung + und Bereitstellung von Verwaltungsunterlagen, Fakultaetsnachlaessen, + Studentenakten und Campusdokumentation. Unterscheidet sich von institutionellen + Repositorien, die hauptsaechlich veroeffentlichte wissenschaftliche Arbeiten + verwalten. + fr: >- + Unite organisationnelle agissant en tant que depositeur officiel du patrimoine + documentaire d'un etablissement d'enseignement superieur. Chargee de l'acquisition, + de la preservation et de la mise a disposition des archives administratives, des + papiers de faculte, des dossiers d'etudiants et de la documentation de campus. + Distincte des repositoris institutionnels qui gerent principalement les productions + scientifiques publiees. + es: >- + Unidad organizativa que sirve como depositario oficial del patrimonio documental + de una institucion de educacion superior. Encargada de adquirir, preservar y + proporcionar acceso a registros administrativos, archivos de profesores, + expedientes estudiantiles y documentacion del campus. Distinguida de los + repositorios institucionales que gestionan principalmente productos academicos + publicados. + ar: >- + وحدة تنظيمية تعمل كحارس رسمي للتراث الوثائقي لمؤسسة التعليم العالي. + مكلفة بالاستحواذ والحفظ وتوفير الوصول إلى السجلات الإدارية وأوراق هيئة + التدريس وملفات الطلاب وتوثيق الحرم الجامعي. يتميز عن المستودعات المؤسسية + التي تدير بشكل رئيسي المخرجات العلمية المنشورة. + id: >- + Unit organisasi yang berfungsi sebagai penjaga resmi warisan dokumenter institusi + pendidikan tinggi. Bertanggung jawab untuk memperoleh, melestarikan, dan + menyediakan akses ke catatan administratif, arsip dosen, catatan mahasiswa, + dan dokumentasi kampus. Dibedakan dari repositori institusional yang terutama + mengelola output ilmiah yang dipublikasikan. + zh: >- + 作为高等教育机构文献遗产官方保管者的组织单位。负责获取、保存和提供对行政 + 记录、教职员档案、学生档案和校园文献的访问。区别于主要管理已发表学术 + 成果的机构存储库。 + examples: + - value: + has_type: hc:ArchiveOrganizationType + has_label: University Archives + has_hypernym: wd:Q166118 + hold_record_set: + - hc:UniversityAdministrativeFonds + - hc:FacultyPaperCollection + description: A university archives institution holding administrative records and faculty papers + - value: + has_type: hc:ArchiveOrganizationType + has_label: College Archives + has_hypernym: wd:Q166118 + hold_record_set: + - hc:AcademicStudentRecordSeries + description: A college archives institution preserving student records is_a: ArchiveOrganizationType class_uri: schema:ArchiveOrganization - description: | - An organizational unit or repository functioning as the official archival custodian - for a higher education institution (e.g., a university, college, or polytechnic). - It is responsible for acquiring, preserving, and providing access to the institution's official administrative records, historical - memory, faculty papers, and documentation of student and campus life. This class specifically represents the custodial - organization managing the collections, rather than the archival record sets themselves, - and is conceptually distinct from institutional repositories that primarily manage - published scholarly research outputs. slots: - has_type - - hold_record_set - - has_hypernym - has_label + - has_hypernym + - hold_record_set - has_score - related_to structured_aliases: - - literal_form: Hochschularchiv - in_language: de - - literal_form: "archivo acad\xE9mico" - in_language: es - - literal_form: "archives acad\xE9miques" - in_language: fr - - literal_form: archivio accademico - in_language: it - literal_form: academisch archief in_language: nl - - literal_form: "arquivo acad\xEAmico" + - literal_form: Hochschularchiv + in_language: de + - literal_form: archives academiques + in_language: fr + - literal_form: archivo academico + in_language: es + - literal_form: أرشيف أكاديمي + in_language: ar + - literal_form: arsip akademik + in_language: id + - literal_form: 学术档案馆 + in_language: zh + - literal_form: archivio accademico + in_language: it + - literal_form: arquivo academico in_language: pt keywords: - administrative records @@ -66,17 +133,20 @@ classes: - campus life documentation slot_usage: hold_record_set: - equals_expression: '["hc:UniversityAdministrativeFonds", "hc:StudentRecordSeries", "hc:FacultyPaperCollection", "hc:CampusDocumentationCollection"] - ' + equals_string_in: + - "hc:UniversityAdministrativeFonds" + - "hc:AcademicStudentRecordSeries" + - "hc:FacultyPaperCollection" + - "hc:CampusDocumentationCollection" identified_by: - pattern: ^Q[0-9]+$ + pattern: "^Q[0-9]+$" has_type: - equals_expression: '["hc:ArchiveOrganizationType"]' + equals_string: "hc:ArchiveOrganizationType" related_to: range: WikidataAlignment inlined: true has_hypernym: - equals_expression: '["wd:Q166118"]' + equals_string: "wd:Q166118" has_label: ifabsent: string(archive) exact_mappings: @@ -86,23 +156,18 @@ classes: - skos:Concept broad_mappings: - wd:Q166118 - - wd:Q124762372 narrow_mappings: - wd:Q2496264 related_mappings: - wd:Q1065413 comments: - - Custodian type class for academic/higher education archives - - 'Part of dual-class pattern: custodian type + rico:RecordSetType' - - Parent institution is typically a university or college - - class_uri is schema:ArchiveOrganization - primary semantic meaning - - skos:broader relationship to wd:Q166118 (archive) expressed via broad_mappings + - Institutional custodian type for higher education archives + - Distinguished from institutional repositories (wd:Q1065413) which manage published scholarly outputs + - The actual holdings are represented by AcademicArchiveRecordSetType instances see_also: - - wd:Q2496264 - - wd:Q124762372 - - wd:Q1065413 - AcademicArchiveRecordSetType + - wd:Q1065413 annotations: - specificity_score: 0.1 - specificity_rationale: Generic utility class/slot created during migration - custodian_types: "['*']" + specificity_score: "0.3" + specificity_rationale: Specific to higher education archival custodians + custodian_types: "['AcademicArchive']" diff --git a/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetType.yaml b/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetType.yaml index a34d8c7b89..aef140a1bd 100644 --- a/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetType.yaml +++ b/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetType.yaml @@ -23,6 +23,39 @@ classes: institutions during their administrative, academic, and operational activities. Distinguishes the classification of holdings from the repository organization responsible for their custody. + alt_descriptions: + nl: >- + Categorie voor het groeperen van documentair materiaal dat door hogeronderwijsinstellingen + is verzameld tijdens hun administratieve, academische en operationele activiteiten. + Onderscheidt de classificatie van bezittingen van de repositoryorganisatie die + verantwoordelijk is voor hun bewaring. + de: >- + Kategorie zur Gruppierung von Dokumentenmaterial, das von Hochschulen während + ihrer administrativen, akademischen und betrieblichen Aktivitäten angesammelt wurde. + Unterscheidet die Klassifizierung der Bestände von der für ihre Verwahrung + verantwortlichen Repository-Organisation. + fr: >- + Catégorie de regroupement des documents accumulés par les établissements d'enseignement + supérieur au cours de leurs activités administratives, académiques et opérationnelles. + Distingue la classification des fonds de l'organisation de conservation responsable + de leur garde. + es: >- + Categoría para agrupar materiales documentales acumulados por instituciones de + educación superior durante sus actividades administrativas, académicas y operativas. + Distingue la clasificación de las tenencias de la organización depositaria responsable + de su custodia. + ar: >- + فئة لتجميع المواد الوثائقية التي جمعتها مؤسسات التعليم العالي خلال أنشطتها + الإدارية والأكاديمية والتشغيلية. تميز تصنيف المقتنيات عن المنظمة المسؤولة + عن حفظها. + id: >- + Kategori untuk mengelompokkan materi dokumenter yang dikumpulkan oleh institusi + pendidikan tinggi selama aktivitas administratif, akademik, dan operasional mereka. + Membedakan klasifikasi koleksi dari organisasi repositori yang bertanggung jawab + atas penyimpanannya. + zh: >- + 高等教育机构在行政、学术和运营活动中积累的文献材料的分类类别。区分馆藏分类与负责 + 保管的存储库组织。 examples: - value: has_type: hc:ArchiveOrganizationType @@ -55,14 +88,20 @@ classes: - Part of dual-class pattern with AcademicArchive (custodian type) - Use AcademicArchive for the archive organization; use this class for collection types structured_aliases: - - literal_form: Hochschularchivbestand - in_language: de - - literal_form: fondo de archivo académico - in_language: es - - literal_form: fonds d'archives académiques - in_language: fr - literal_form: academisch archiefbestand in_language: nl + - literal_form: Hochschularchivbestand + in_language: de + - literal_form: fonds d'archives académiques + in_language: fr + - literal_form: fondo de archivo académico + in_language: es + - literal_form: مجموعة الأرشيف الأكاديمي + in_language: ar + - literal_form: koleksi arsip akademik + in_language: id + - literal_form: 学术档案集 + in_language: zh slot_usage: has_type: equals_string: "hc:ArchiveOrganizationType" diff --git a/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetTypes.yaml b/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetTypes.yaml index 08fdeda688..ed724368c8 100644 --- a/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetTypes.yaml +++ b/schemas/20251121/linkml/modules/classes/AcademicArchiveRecordSetTypes.yaml @@ -20,30 +20,71 @@ imports: - ../slots/has_scope classes: UniversityAdministrativeFonds: + description: >- + Records created or accumulated by a university's central administration in the + exercise of governance, policy-making, and operational functions. Organized + according to archival principles of provenance (respect des fonds). + alt_descriptions: + nl: >- + Archiefbescheiden gecreeerd of verzameld door de centrale administratie van een + universiteit bij de uitoefening van bestuurlijke, beleidsmatige en operationele + functies. Georganiseerd volgens archivistische beginselen van herkomst. + de: >- + Unterlagen, die von der Zentralverwaltung einer Universitaet bei der Ausuebung + von Regierungs-, Politik- und Betriebsfunktionen erstellt oder gesammelt wurden. + Nach archivarischen Prinzipien der Provenienz organisiert. + fr: >- + Documents crees ou accumules par l'administration centrale d'une universite dans + l'exercice de fonctions de gouvernance, d'elaboration de politiques et + operationnelles. Organises selon les principes archivistiques de provenance. + es: >- + Registros creados o acumulados por la administracion central de una universidad + en el ejercicio de funciones de gobernanza, formulacion de politicas y + operaciones. Organizados segun principios archivisticos de procedencia. + ar: >- + سجلات تم إنشاؤها أو تجميعها من قبل الإدارة المركزية للجامعة في ممارسة وظائف + الحوكمة وصنع السياسات والعمليات. منظمة حسب المبادئ الأرشيفية للمصدر. + id: >- + Catatan yang dibuat atau dikumpulkan oleh administrasi pusat universitas dalam + menjalankan fungsi tata kelola, pembuatan kebijakan, dan operasional. Diatur + menurut prinsip arsip provenans. + zh: >- + 大学中央行政管理部门在行使治理、决策和运营职能时创建或积累的记录。按照档案 + 来源原则组织。 + examples: + - value: + has_type: hc:ArchiveOrganizationType + has_label: Board of Trustees Minutes + has_note: Meeting minutes, resolutions, and supporting documents + description: Governance records from university board of trustees + - value: + has_type: hc:ArchiveOrganizationType + has_label: Faculty Senate Records + has_note: Senate minutes, committee reports, policy proposals + description: Faculty governance documentation from university senate is_a: AcademicArchiveRecordSetType class_uri: rico:RecordSetType - description: "A rico:RecordSetType for university administrative records organized\ - \ as a fonds.\n\n**Definition**:\nRecords created or accumulated by a university's\ - \ central administration in the \nexercise of governance, policy-making, and\ - \ operational functions. Organized \naccording to archival principles of provenance\ - \ (respect des fonds).\n\n**Typical Contents**:\n- Governance records (board\ - \ minutes, resolutions, bylaws)\n- Committee records (senate, faculty councils,\ - \ standing committees)\n- Policy records (institutional policies, procedures,\ - \ guidelines)\n- Strategic planning documents\n- Accreditation and institutional\ - \ assessment records\n- Executive correspondence\n\n**RiC-O Alignment**:\nThis\ - \ class is a specialized rico:RecordSetType. Records classified with this\n\ - type follow the fonds organizational principle as defined by rico-rst:Fonds\n\ - (respect des fonds / provenance-based organization from university central administration).\n" + slots: + - has_type + - has_score + - has_note + - has_scope structured_aliases: - - literal_form: Hochschulverwaltungsbestand - in_language: de - - literal_form: "fondo de administraci\xF3n universitaria" - in_language: es - - literal_form: fonds d'administration universitaire - in_language: fr - literal_form: universiteitsbestuursarchief in_language: nl - - literal_form: "fundo de administra\xE7\xE3o universit\xE1ria" + - literal_form: Hochschulverwaltungsbestand + in_language: de + - literal_form: fonds d'administration universitaire + in_language: fr + - literal_form: fondo de administracion universitaria + in_language: es + - literal_form: أرشيف الإدارة الجامعية + in_language: ar + - literal_form: arsip administrasi universitas + in_language: id + - literal_form: 大学行政档案 + in_language: zh + - literal_form: fundo de administracao universitaria in_language: pt keywords: - governance records @@ -56,70 +97,96 @@ classes: - accreditation records - executive correspondence - institutional bylaws + - resolutions + - procedures + - guidelines + slot_usage: + has_type: + equals_string: "hc:ArchiveOrganizationType" broad_mappings: - rico:RecordSetType + - skos:Concept related_mappings: - rico-rst:Fonds - wd:Q1643722 - - rico:RecordSetType - - skos:Concept - close_mappings: - - skos:Concept see_also: - AcademicArchiveRecordSetType - rico:RecordSetType - rico-rst:Fonds + comments: + - Records follow the fonds organizational principle reflecting provenance from university central administration + - Subject to records retention schedules and institutional access policies + annotations: + specificity_score: "0.5" + specificity_rationale: Specific to university administrative records + custodian_types: "['AcademicArchive']" + AcademicStudentRecordSeries: + description: >- + Records documenting the academic careers and activities of students, typically + organized as series within a larger university fonds. Subject to retention + schedules and privacy regulations (FERPA in US, GDPR in EU, AVG in NL). + alt_descriptions: + nl: >- + Archiefbescheiden die de academische carrieeres en activiteiten van studenten + documenteren, doorgaans georganiseerd als series binnen een groter universitair + fonds. Onderworpen aan bewaartermijnen en privacyregelgeving. + de: >- + Unterlagen, die die akademischen Karrieren und Aktivitaeten von Studenten + dokumentieren, typischerweise als Serie innerhalb eines groesseren + Universitaetsfonds organisiert. Unterliegen Aufbewahrungsfristen und + Datenschutzbestimmungen. + fr: >- + Documents recensant les carrieres et activites academiques des etudiants, + generalement organises en series au sein d'un fonds universitaire plus vaste. + Soumis a des delais de conservation et a des reglementations de confidentialite. + es: >- + Registros que documentan las carreras academicas y actividades de los estudiantes, + generalmente organizados como series dentro de un fondo universitario mas amplio. + Sujetos a programas de retencion y regulaciones de privacidad. + ar: >- + سجلات توثق المسارات الأكاديمية وأنشطة الطلاب، وعادة ما تكون منظمة كسلاسل + ضمن صندوق جامعي أكبر. تخضع لجداول الاحتفاظ ولوائح الخصوصية. + id: >- + Catatan yang mendokumentasikan karir dan aktivitas akademik mahasiswa, biasanya + diatur sebagai seri dalam dana universitas yang lebih besar. Tunduk pada jadwal + retensi dan peraturan privasi. + zh: >- + 记录学生学术生涯和活动的记录，通常作为较大大学档案中的系列组织。受保留 + 时间表和隐私法规约束。 + examples: + - value: + has_type: hc:ArchiveOrganizationType + has_label: Registrar Student Records + has_note: Enrollment, transcripts, graduation records with privacy restrictions + description: Student academic records series with 75-year retention period + - value: + has_type: hc:ArchiveOrganizationType + has_label: Historical Student Records + has_note: Pre-1950 student records with fewer access restrictions + description: Historical student records open for research access + is_a: AcademicArchiveRecordSetType + class_uri: rico:RecordSetType slots: - has_type - has_score - has_note - - has_type - has_scope - - has_scope - slot_usage: - has_type: - equals_expression: '["hc:ArchiveOrganizationType"]' - has_type: - equals_string: UniversityAdministrativeFonds - has_note: - equals_string: This RecordSetType classifies record sets following the fonds - principle. The fonds structure reflects provenance from university central - administration. - has_scope: - equals_string: '["governance records", "committee records", "policy records", - "strategic planning", "accreditation records"]' - has_scope: - equals_string: '["student records", "faculty papers", "research data"]' - annotations: - specificity_score: 0.1 - specificity_rationale: Generic utility class/slot created during migration - custodian_types: '[''*'']' - AcademicStudentRecordSeries: - is_a: AcademicArchiveRecordSetType - class_uri: rico:RecordSetType - description: "A rico:RecordSetType for student records organized as archival series.\n\ - \n**Definition**:\nRecords documenting the academic careers and activities of\ - \ students, typically \norganized as series within a larger university fonds.\ - \ Subject to retention \nschedules and privacy regulations (FERPA in US, GDPR\ - \ in EU, AVG in NL).\n\n**Typical Contents**:\n- Enrollment and registration\ - \ records\n- Academic transcripts and grade records\n- Graduation records and\ - \ diploma registers\n- Disciplinary records\n- Financial aid records\n- Student\ - \ organization records\n\n**Privacy Considerations**:\nAccess restrictions typically\ - \ apply due to personally identifiable information.\nHistorical student records\ - \ (typically 75+ years) may have fewer restrictions.\n\n**RiC-O Alignment**:\n\ - This class is a specialized rico:RecordSetType. Records classified with this\n\ - type follow the series organizational principle as defined by rico-rst:Series\n\ - (organizational level within the university fonds).\n" structured_aliases: - - literal_form: Studentenaktenserie - in_language: de - - literal_form: serie de expedientes estudiantiles - in_language: es - - literal_form: "s\xE9rie de dossiers \xE9tudiants" - in_language: fr - literal_form: studentendossiers in_language: nl - - literal_form: "s\xE9rie de registros de alunos" + - literal_form: Studentenaktenserie + in_language: de + - literal_form: serie de dossiers etudiants + in_language: fr + - literal_form: serie de expedientes estudiantiles + in_language: es + - literal_form: سجلات الطلاب + in_language: ar + - literal_form: seri catatan mahasiswa + in_language: id + - literal_form: 学生档案系列 + in_language: zh + - literal_form: serie de registros de alunos in_language: pt keywords: - enrollment records @@ -132,71 +199,98 @@ classes: - disciplinary records - student organizations - financial aid records + slot_usage: + has_type: + equals_string: "hc:ArchiveOrganizationType" broad_mappings: - rico:RecordSetType + - skos:Concept related_mappings: - rico-rst:Series - wd:Q185583 - - rico:RecordSetType - - skos:Concept - close_mappings: - - skos:Concept see_also: - AcademicArchiveRecordSetType - rico:RecordSetType - rico-rst:Series - UniversityAdministrativeFonds + comments: + - Records follow the series organizational principle within the university fonds + - Access restrictions typically apply for records less than 75 years old + - Subject to educational records privacy laws (FERPA, GDPR, AVG) + annotations: + specificity_score: "0.5" + specificity_rationale: Specific to student academic records + custodian_types: "['AcademicArchive']" + FacultyPaperCollection: + description: >- + Personal papers of faculty members documenting their academic careers, research + activities, teaching, and professional service. Typically acquired as donations + or bequests, distinct from official university records. + alt_descriptions: + nl: >- + Persoonlijke archieven van hoogleraren die hun academische carrieeres, + onderzoeksactiviteiten, onderwijs en professionele dienst documenteren. + Doorgaans verkregen door schenking of legaat, te onderscheiden van officiële + universitaire archieven. + de: >- + Persoenliche Papiere von Fakultaetsmitgliedern, die ihre akademischen Karrieren, + Forschungsaktivitaeten, Lehre und den professionellen Dienst dokumentieren. + In der Regel durch Schenkungen oder Vermaechtnisse erworben, getrennt von + offiziellen Universitaetsunterlagen. + fr: >- + Papiers personnels des membres du corps professoral documentant leurs carrieres + academiques, activites de recherche, enseignement et service professionnel. + Generalement acquis par don ou legs, distincts des archives universitaires + officielles. + es: >- + Papeles personales de los miembros de la facultad que documentan sus carreras + academicas, actividades de investigacion, docencia y servicio profesional. + Tipicamente adquiridos como donaciones o legados, distintos de los registros + universitarios oficiales. + ar: >- + أوراق شخصية لأعضاء هيئة التدريس توثق مسيرتهم الأكاديمية وأنشطة البحث + والتدريس والخدمة المهنية. عادة ما يتم الحصول عليها كتبرعات أو وصايا، + ومتميزة عن السجلات الجامعية الرسمية. + id: >- + Arsip pribadi anggota fakultas yang mendokumentasikan karir akademik, kegiatan + penelitian, pengajaran, dan layanan profesional. Biasanya diperoleh melalui + donasi atau warisan, berbeda dari catatan universitas resmi. + zh: >- + 教职员个人档案，记录其学术生涯、研究活动、教学和专业服务。通常通过捐赠 + 或遗赠获得，与官方大学记录不同。 + examples: + - value: + has_type: hc:ArchiveOrganizationType + has_label: Professor Smith Papers + has_note: Research notes, correspondence, lecture materials, conference papers + description: Personal papers of a professor including research documentation + - value: + has_type: hc:ArchiveOrganizationType + has_label: Department Chair Archive + has_note: Administrative correspondence, committee service records, teaching materials + description: Faculty papers from a department chair with administrative responsibilities + is_a: AcademicArchiveRecordSetType + class_uri: rico:RecordSetType slots: - has_type - has_score - has_note - - has_note - - has_type - has_scope - - has_scope - slot_usage: - has_type: - equals_expression: '["hc:ArchiveOrganizationType"]' - has_type: - equals_string: AcademicStudentRecordSeries - has_note: - equals_string: This RecordSetType classifies record sets following the series - principle. Typically a series within the university administration fonds - or registrar's office fonds. - has_scope: - equals_string: '["enrollment records", "academic transcripts", "graduation - records", "disciplinary records", "financial aid records"]' - has_scope: - equals_string: '["faculty records", "research records", "administrative policy"]' - has_note: - equals_string: Subject to educational records privacy laws (FERPA, GDPR, AVG). Access - restrictions typically apply for records less than 75 years old. - FacultyPaperCollection: - is_a: AcademicArchiveRecordSetType - class_uri: rico:RecordSetType - description: "A rico:RecordSetType for faculty papers and personal archives.\n\ - \n**Definition**:\nPersonal papers of faculty members documenting their academic\ - \ careers, research \nactivities, teaching, and professional service. These\ - \ are typically acquired as \ndonations or bequests, distinct from official\ - \ university records.\n\n**Typical Contents**:\n- Research documentation and\ - \ notes\n- Correspondence (professional and personal)\n- Lecture notes and course\ - \ materials\n- Manuscripts and drafts\n- Conference papers and presentations\n\ - - Professional organization records\n- Photographs and audiovisual materials\n\ - \n**Provenance**:\nUnlike administrative fonds, faculty papers are personal\ - \ archives with the \nindividual faculty member as creator/accumulator. The\ - \ university acquires \ncustody but respects original order where it exists.\n\ - \n**RiC-O Alignment**:\nThis class is a specialized rico:RecordSetType. Records\ - \ classified with this\ntype follow the fonds organizational principle as defined\ - \ by rico-rst:Fonds\n(personal papers fonds with the faculty member as creator/accumulator).\n" structured_aliases: - - literal_form: Professorennachlass - in_language: de - - literal_form: archivo personal de profesores - in_language: es - - literal_form: fonds de professeurs - in_language: fr - literal_form: hoogleraarspapieren in_language: nl + - literal_form: Professorennachlass + in_language: de + - literal_form: fonds de professeurs + in_language: fr + - literal_form: archivo personal de profesores + in_language: es + - literal_form: أوراق هيئة التدريس + in_language: ar + - literal_form: arsip fakultas + in_language: id + - literal_form: 教职员档案 + in_language: zh - literal_form: arquivo pessoal de docentes in_language: pt keywords: @@ -208,117 +302,145 @@ classes: - conference papers - professional papers - academic papers + - correspondence + - manuscripts + - drafts + - professional organization records + - photographs + - audiovisual materials + slot_usage: + has_type: + equals_string: "hc:ArchiveOrganizationType" broad_mappings: - rico:RecordSetType + - skos:Concept related_mappings: - rico-rst:Fonds - wd:Q22075301 - - rico:RecordSetType - - skos:Concept close_mappings: - - skos:Concept - bf:Archival see_also: - AcademicArchiveRecordSetType - rico:RecordSetType - rico-rst:Fonds + comments: + - Personal archives with individual faculty member as creator/accumulator + - Typically acquired through donation or bequest with possible donor restrictions + - Respects original order where it exists annotations: - acquisition_note: Typically acquired through donation or bequest. May include - restrictions on access or publication specified by donor agreement. + specificity_score: "0.5" + specificity_rationale: Specific to faculty personal papers + custodian_types: "['AcademicArchive']" + acquisition_note: "Typically acquired through donation or bequest. May include restrictions on access or publication specified by donor agreement." + CampusDocumentationCollection: + description: >- + Materials documenting campus life, institutional identity, and university culture + beyond formal administrative records. Often includes visual materials, publications, + and ephemera capturing the lived experience of the institution. + alt_descriptions: + nl: >- + Materialen die campusleven, institutionele identiteit en universiteitscultuur + documenteren buiten formele administratieve archieven om. Vaak inclusief visuele + materialen, publicaties en efemeriteit die de leefwereld van de instelling + vastleggen. + de: >- + Materialien, die das Campusleben, die institutionelle Identitaet und die + Universitaetskultur jenseits formaler Verwaltungsunterlagen dokumentieren. + Oft visuelle Materialien, Veroeffentlichungen und Ephemera, die die gelebte + Erfahrung der Institution einfangen. + fr: >- + Documents recensant la vie du campus, l'identite institutionnelle et la culture + universitaire au-dela des archives administratives formelles. Inclut souvent + des materiels visuels, des publications et des ephemeres capturant l'experience + vecue de l'institution. + es: >- + Materiales que documentan la vida del campus, la identidad institucional y la + cultura universitaria mas alla de los registros administrativos formales. A + menudo incluye materiales visuales, publicaciones y efimeras que capturan la + experiencia vivida de la institucion. + ar: >- + مواد توثق حياة الحرم الجامعي والهوية المؤسسية وثقافة الجامعة خارج السجلات + الإدارية الرسمية. غالبا ما تتضمن مواد مرئية ومنشورات ومقتنيات عابرة + تسجل التجربة المعاشة للمؤسسة. + id: >- + Materi yang mendokumentasikan kehidupan kampus, identitas institusional, dan + budaya universitas di luar catatan administratif formal. Sering menyertakan + materi visual, publikasi, dan efemera yang menangkap pengalaman hidup institusi. + zh: >- + 记录校园生活、机构身份和大学文化的材料，超越正式行政记录。通常包括视觉 + 材料、出版物和捕捉机构生活体验的临时性材料。 + examples: + - value: + has_type: hc:ArchiveOrganizationType + has_label: Campus Photograph Collection + has_note: Historical photographs, yearbooks, event programs, oral histories + description: Campus life documentation including photographs and publications + - value: + has_type: hc:ArchiveOrganizationType + has_label: Student Newspaper Archive + has_note: Student newspapers, magazines, ephemera, memorabilia + description: Student publication documentation with campus culture materials + is_a: AcademicArchiveRecordSetType + class_uri: rico:RecordSetType slots: - has_type - has_score - has_note - - has_type - has_scope - - has_scope - slot_usage: - has_type: - equals_expression: '["hc:ArchiveOrganizationType", "hc:LibraryType"]' - has_type: - equals_string: FacultyPaperCollection - has_note: - equals_string: This RecordSetType classifies record sets following the fonds - principle. Personal archives with individual faculty member as creator/accumulator. - has_scope: - equals_string: '["research documentation", "correspondence", "lecture notes", - "manuscripts", "conference papers"]' - has_scope: - equals_string: '["official university records", "student records", "administrative - files"]' - CampusDocumentationCollection: - is_a: AcademicArchiveRecordSetType - class_uri: rico:RecordSetType - description: "A rico:RecordSetType for campus life and institutional documentation.\n\ - \n**Definition**:\nMaterials documenting campus life, institutional identity,\ - \ and university \nculture beyond formal administrative records. Often includes\ - \ visual materials, \npublications, and ephemera that capture the lived experience\ - \ of the institution.\n\n**Typical Contents**:\n- Campus photographs and audiovisual\ - \ materials\n- University publications (yearbooks, newspapers, magazines)\n\ - - Ephemera (programs, posters, invitations)\n- Memorabilia and artifacts\n-\ - \ Oral histories\n- Event documentation\n- Building and facilities documentation\n\ - \n**Collection Nature**:\nMay be assembled collections (artificial) rather than\ - \ strictly provenance-based,\nespecially for ephemera and visual materials.\ - \ Documentation value often takes\nprecedence over strict archival arrangement.\n\ - \n**RiC-O Alignment**:\nThis class is a specialized rico:RecordSetType. Records\ - \ classified with this\ntype follow the collection organizational principle\ - \ as defined by rico-rst:Collection\n(assembled/artificial collection organized\ - \ by subject or documentation purpose).\n" structured_aliases: - - literal_form: Campus-Dokumentationssammlung - in_language: de - - literal_form: "colecci\xF3n de documentaci\xF3n del campus" - in_language: es - - literal_form: collection de documentation du campus - in_language: fr - literal_form: campusdocumentatiecollectie in_language: nl - - literal_form: "cole\xE7\xE3o de documenta\xE7\xE3o do campus" + - literal_form: Campus-Dokumentationssammlung + in_language: de + - literal_form: collection de documentation du campus + in_language: fr + - literal_form: coleccion de documentacion del campus + in_language: es + - literal_form: توثيق الحرم الجامعي + in_language: ar + - literal_form: koleksi dokumentasi kampus + in_language: id + - literal_form: 校园文献集 + in_language: zh + - literal_form: colecao de documentacao do campus in_language: pt keywords: - campus photographs - audiovisual materials - university publications - student newspapers + - yearbooks + - magazines - oral histories - event documentation - building documentation - campus life + - ephemera + - programs + - posters + - memorabilia + - artifacts + slot_usage: + has_type: + equals_string: "hc:ArchiveOrganizationType" broad_mappings: - rico:RecordSetType + - skos:Concept related_mappings: - rico-rst:Collection - wd:Q9388534 - - rico:RecordSetType - - skos:Concept close_mappings: - - skos:Concept - schema:Collection see_also: - AcademicArchiveRecordSetType - rico:RecordSetType - rico-rst:Collection + comments: + - Often includes assembled/artificial collections organized by subject or documentation purpose + - May prioritize documentation value over strict archival arrangement + - Can include ephemera, memorabilia, and visual materials annotations: - collection_nature_note: Often includes artificial/assembled collections organized - by subject, format, or documentation purpose rather than strict provenance. - slots: - - has_type - - has_score - - has_note - - has_type - - has_scope - - has_scope - slot_usage: - has_type: - equals_expression: '["hc:ArchiveOrganizationType", "hc:LibraryType", "hc:MuseumType"]' - has_type: - equals_string: CampusDocumentationCollection - has_note: - equals_string: This RecordSetType classifies record sets following the collection - principle. May be assembled collection (artificial) organized by subject - or documentation purpose. - has_scope: - equals_string: '["photographs", "audiovisual materials", "publications", "ephemera", - "oral histories", "memorabilia"]' - has_scope: - equals_string: '["administrative records", "student records", "faculty papers"]' + specificity_score: "0.5" + specificity_rationale: Specific to campus documentation materials + custodian_types: "['AcademicArchive']" + collection_nature_note: "Often includes artificial/assembled collections organized by subject, format, or documentation purpose rather than strict provenance."