This repository was archived by the owner on Nov 21, 2025. It is now read-only.
Organize and consolidate documentation #132
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This commit consolidates and clarifies the documentation structure, making it easier to navigate and understand the project's direction. Changes: - Moved root-level analysis docs to docs/analysis/: * DOMAIN_VALIDATION_REPORT.md * KAIRO_RENAME_ANALYSIS.md - Moved LEVEL_3_TYPE_SYSTEM.md to docs/specifications/level-3-type-system.md for better organization alongside other specifications - Consolidated archive directories: * Moved archive/historical/ to docs/archive/historical/ * Moved archive/root-level-docs/ to docs/archive/root-level-docs/ * All archives now properly organized under docs/archive/ - Created comprehensive Language Features Roadmap: * docs/roadmap/language-features.md * Clear path to language 1.0 (target: 2026 Q2) * Production-ready vs planned features * Features under discussion (macros, effects, ownership, pattern matching) * Decision framework for new features * Community input process - Updated documentation navigation: * docs/README.md: Added language roadmap, updated links * README.md: Fixed reference to moved type system spec * STATUS.md: Updated header to "Kairo (Morphogen)" for clarity All documentation is now properly organized in docs/ subdirectories with clear categorization (philosophy, architecture, specifications, roadmap, planning, analysis, archive, etc.). This provides a clear path forward for language development and makes the project more accessible to new contributors.
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This commit consolidates and clarifies the documentation structure, making it easier to navigate and understand the project's direction.
Changes:
Moved root-level analysis docs to docs/analysis/:
Moved LEVEL_3_TYPE_SYSTEM.md to docs/specifications/level-3-type-system.md for better organization alongside other specifications
Consolidated archive directories:
Created comprehensive Language Features Roadmap:
Updated documentation navigation:
All documentation is now properly organized in docs/ subdirectories with clear categorization (philosophy, architecture, specifications, roadmap, planning, analysis, archive, etc.).
This provides a clear path forward for language development and makes the project more accessible to new contributors.