78 lines
2.5 KiB
YAML
78 lines
2.5 KiB
YAML
|
# MarkiTect Schema Catalog
|
||
|
|
#
|
||
|
|
# This catalog provides metadata about available schemas for markdown document validation.
|
||
|
|
# Schemas can be referenced by name or loaded from their file path.
|
||
|
|
|
||
|
|
version: "1.0"
|
||
|
|
description: "Catalog of registered MarkiTect schemas for document validation"
|
||
|
|
|
||
|
|
schemas:
|
||
|
|
- id: "markitect-metaschema"
|
||
|
|
name: "MarkiTect Metaschema"
|
||
|
|
file: "markitect-metaschema.json"
|
||
|
|
version: "1.0"
|
||
|
|
description: "Metaschema for validating MarkiTect schema extensions"
|
||
|
|
type: "metaschema"
|
||
|
|
usage: "Used internally to validate schema files with MarkiTect-specific extensions"
|
||
|
|
tags:
|
||
|
|
- internal
|
||
|
|
- validation
|
||
|
|
- metaschema
|
||
|
|
|
||
|
|
- id: "terminology-v1"
|
||
|
|
name: "Terminology Document Schema"
|
||
|
|
file: "terminology-schema.json"
|
||
|
|
version: "1.0"
|
||
|
|
description: "Schema for validating terminology and glossary documents"
|
||
|
|
type: "document-schema"
|
||
|
|
usage: "Validates technical glossaries, terminology documents, and definition lists"
|
||
|
|
document_types:
|
||
|
|
- glossary
|
||
|
|
- terminology
|
||
|
|
- lexicon
|
||
|
|
- dictionary
|
||
|
|
features:
|
||
|
|
- Heading hierarchy validation (H1 → H2 → H3)
|
||
|
|
- Term structure validation (Definition, Synonyms, Related Terms, etc.)
|
||
|
|
- Content quality metrics (word counts, readability)
|
||
|
|
- MarkiTect extensions (x-markitect-sections, x-markitect-content-control)
|
||
|
|
- Classification system (required/recommended/optional)
|
||
|
|
example: "examples/terminology/terminology-example.md"
|
||
|
|
tags:
|
||
|
|
- documentation
|
||
|
|
- glossary
|
||
|
|
- terminology
|
||
|
|
- definitions
|
||
|
|
related_schemas: []
|
||
|
|
author: "MarkiTect Project"
|
||
|
|
created: "2026-01-04"
|
||
|
|
updated: "2026-01-04"
|
||
|
|
|
||
|
|
# Future schemas to add:
|
||
|
|
#
|
||
|
|
# - id: "manpage-v1"
|
||
|
|
# name: "Unix Manual Page Schema"
|
||
|
|
# description: "Schema for Unix/Linux manual page documentation"
|
||
|
|
#
|
||
|
|
# - id: "api-reference-v1"
|
||
|
|
# name: "API Reference Schema"
|
||
|
|
# description: "Schema for API endpoint documentation"
|
||
|
|
#
|
||
|
|
# - id: "arc42-v1"
|
||
|
|
# name: "arc42 Architecture Documentation Schema"
|
||
|
|
# description: "Schema for arc42 architecture documentation template"
|
||
|
|
#
|
||
|
|
# - id: "adr-v1"
|
||
|
|
# name: "Architecture Decision Record Schema"
|
||
|
|
# description: "Schema for ADR (Architecture Decision Record) documents"
|
||
|
|
#
|
||
|
|
# - id: "rfc-v1"
|
||
|
|
# name: "RFC/Specification Schema"
|
||
|
|
# description: "Schema for RFC-style specification documents"
|
||
|
|
|
||
|
|
# Schema discovery paths:
|
||
|
|
# - Built-in: markitect/schemas/*.json
|
||
|
|
# - User-defined: ~/.markitect/schemas/*.json
|
||
|
|
# - Project-specific: .markitect/schemas/*.json
|
||
|
|
# - Custom paths via MARKITECT_SCHEMA_PATH environment variable
|