ChrisOS Research Project Technical systems documentation

Source reference: docs/README.md

In this chapter

Deterministic source record. The complete textual file is reproduced below; this page does not replace architectural interpretation in the authored chapters.

File identity

Field Value
Path docs/README.md
Lines 30
Bytes 1372
SHA-256 441a2507d4fef2f421a71165fc2b4663db67fcda56e2e4ccbfb4aceae46409aa
ChrisOS revision 92fb561574bd929522ea005b9fd433138bea3236

Detected syntactic dependencies

Line Include
— No preprocessor include detected.

Detected symbols

Line Symbol
— No C-like function definition detected by the scanner.

Complete source

The following block is the complete textual file at the recorded revision. No lines are elided, abbreviated or paraphrased.

# Repository-local documentation

The **canonical ChrisOS documentation is https://os.christiansoftware.org/**.

This directory is intentionally small. It contains only instructions that must stay close to the repository because they describe how to work with the current source tree.

## Kept here

### Getting started
- [Development environment](getting-started/environment.md)
- [Build and run](getting-started/build-and-run.md)

### Development
- [Development workflow](development/workflow.md)
- [Testing and evidence](development/testing.md)

Also see [Contributing](../CONTRIBUTING.md) and [Security policy](../SECURITY.md).

## Not maintained here

Architecture, subsystem design, ABIs, implementation-status snapshots, hardware matrices, audits, campaign reports, plans, roadmaps, ChrisVM/ChrisCPU documentation, toolchain documentation and educational chapters belong in **https://os.christiansoftware.org/** and its source repository, `christianrss/chrisos_site`.

This avoids two competing documentation trees and prevents historical status files from being mistaken for the current state.

## Rule

If a change affects setup, build, run, test or contribution mechanics, update these repository-local guides.

If a change affects architecture, behavior, specifications, subsystem documentation, capability status or project direction, update **chrisos_site**.

Role of this record

The atlas guarantees file-by-file traceability. Responsibility, invariants, ownership, concurrency, security, performance and subsystem interactions belong in authored chapters and must cite this file when applicable.

Document record
ID: source-441a2507d4fef2f4 Reviewed source: 92fb561574bd Class: generated-source-reference