Thank you for your interest in improving the KID Framework! This document provides guidelines for contributions.
| Type | Description | Example |
|---|---|---|
| 🐛 Error Correction | Fix mathematical errors, typos, or logical inconsistencies | Incorrect formula, spelling mistake |
| 📚 Documentation | Improve clarity, translations, or navigation | Better explanations, German→English translations |
| 🔬 Scientific Extension | Add new framework integrations or theorems | Bridge theorem to new theory |
| Identify new limitations or vulnerabilities | Logical fallacies, category errors | |
| 🎨 Visual Improvements | Diagrams, flowcharts, better formatting | Mermaid diagrams, infographics |
- Philosophical arguments without formal backing — The framework requires mathematical or logical rigor
- Unacknowledged speculation — All claims must acknowledge their heuristic status
- Removal of limitation warnings — Critical vulnerabilities must remain visible
- Anthropomorphic language — Use terminology from
terminology_refactoring_summary.md
- Read
RESIDUAL_LIMITATIONS_REPORT.md - Check if your contribution addresses a known limitation
- Review existing terminology in
terminology_refactoring_summary.md
# Fork the repository
# Create a feature branch
git checkout -b feature/your-improvement
# Make your changes
# Follow the style guide below
# Commit with clear messages
git commit -m "Fix: Corrected dimensional analysis in T2.1"
git commit -m "Docs: Added Mermaid diagram to README"
git commit -m "Critique: Identified new category error in CV-5"- Open a Pull Request with clear description
- Reference any related issues
- Acknowledge if changes affect axioms/theorems (requires review)
| Document Type | Language |
|---|---|
| Philosophical texts | 🇩🇪 German (preserve original) |
| Scientific reports | 🇬🇧 English |
| Mathematical notation | 🔢 Universal |
- Use LaTeX format for equations
- Include dimensional analysis for new quantities
- Reference existing theorems when building new ones
Use scientific replacements, NOT teleological language:
| ❌ Avoid | ✅ Use Instead |
|---|---|
| "Universum sucht nach Ordnung" | "Ordnung emergiert als spontaner Symmetriebruch" |
| "Strategie der Evolution" | "Dynamik der evolutionären Selektion" |
| "Schutzfunktion" | "Strukturelle Begrenzung" |
All contributions will be reviewed for:
- Accuracy — Mathematical correctness
- Consistency — Alignment with existing formalization
- Transparency — Clear acknowledgment of limitations
- Rigor — Avoidance of anthropomorphisms and category errors
- Documentation — Proper citations and cross-references
Contributors will be acknowledged in:
- CHANGELOG.md for their contributions
- Release notes for significant improvements
- Academic citations if contribution leads to publications
Open an issue for:
- Clarification on framework aspects
- Discussion of potential contributions
- Reporting errors without a fix ready
Thank you for helping improve the KID Framework! 🧠⚛️