Contributing

Thanks for your interest in contributing to this project.

Scope

This repository is documentation-first. Contributions are welcome for:

• clarity and consistency improvements
• framework test cases and validation protocols
• translation and editorial quality
• issue reproduction and version diffs

Before You Open a PR

1. Read README.md and INDEX.md
2. Confirm whether the target file is canonical or legacy
3. Open an issue for significant structural or ontological changes

Contribution Rules

• Keep released versioned files stable; a change of substance ships as a new edition; a wording patch is applied in place with a dated patch note
• Update by addition; a full rewrite becomes a new versioned file
• Add clear rationale for any change in epistemic rules
• State behaviour claims as observed, reproducible behaviour, with the example that reproduces them

Commit and PR Guidance

• One topic per PR
• Clear title: module: short summary
• Include:
  • what changed
  • why
  • compatibility impact
  • validation method

Documentation Style

• Keep section numbering consistent with existing files
• Preserve bilingual style where already used
• Define each term explicitly; a metaphor illustrates a definition already given