docs: reorganise -- current reference gathered, finished work archived, superseded and dead ideas marked as such
docs/CLAUDE.md Phase 2, 2026-10-14. All moves by git mv; every archived file carries a header saying what it is, why, and where to look instead. - docs/reference/ (new): roadmap and versioning policy, M7.1, word-ACL design, kernel args, hosted acceptance test, dictionary, primitives, ontology, L8 table -- previously spread over docs/, docs/lithosananke/ and docs/03-architecture/. - docs/working/archive/historical/: finished work (session plan, test-gap audit, birthing plan, fix write-ups, the January architecture draft). - docs/working/archive/superseded/: the Hermes-VM Tripod docs and July Hermes designs (-> FABRIC-3.5/3.6), the StarForth roadmap, every working doc already flagged superseded or obsolete. - docs/working/archive/dead/: the hal_* target contract (never adopted), L4Re, metrics-and-knobs. - Papers and proposals into docs/working/papers/. - References rewritten across the repo (not logs/, not docs/patent/); CLAUDE.md's documentation section rewritten. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
1a4b163861
commit
7aed588f78
+2
-2
@@ -9,7 +9,7 @@ Thank you for your interest in contributing to StarForth! This document provides
|
||||
3. **Run tests**: `make test` (all 780+ tests must pass)
|
||||
4. **Read** [ONTOLOGY.md](ONTOLOGY.md) for formal definitions and terminology
|
||||
5. **Read** `docs/CLAUDE.md` for project overview
|
||||
6. **Explore** `docs/03-architecture/` for architecture details
|
||||
6. **Explore** `docs/README.md` (the documentation map) for architecture details
|
||||
|
||||
**Important:** All contributors must use terminology from [ONTOLOGY.md](ONTOLOGY.md) in code comments and documentation. This ensures precise, academically rigorous language throughout the project.
|
||||
|
||||
@@ -36,7 +36,7 @@ void function_name(VM *vm) {
|
||||
### Platform Abstraction
|
||||
- **Never** call platform-specific APIs directly from VM code
|
||||
- **Always** use HAL interfaces (`hal_time.h`, `hal_memory.h`, etc.)
|
||||
- See `docs/03-architecture/hal/` for HAL documentation
|
||||
- See `kernel/src/hal/README.md` for the HAL as built
|
||||
|
||||
### Memory Safety
|
||||
- Use `vaddr_t` for VM addresses (not C pointers)
|
||||
|
||||
Reference in New Issue
Block a user