Files
bare-operating-system/users-manual/08-further-reading.md
T
Raven Scott 9dcfaa8b1d - Add first-party vs vendored rules to verify-banned-terminology; naming docs,
alias matrix, verify-naming-alias-matrix in pretest
- Canonical bareOsRegisterBootStepHook / Invoke / EmitBareBootStepHint with
  legacy *Phase* wrappers; typings, runtime caps, docs, CHANGELOG
- VFS: evaluateBareOsVfsPathPolicy; rename hypercore-pack proc locals; add
  /proc/bare_os/security_posture.json
- Stock kernel: invokeCtxBootHooks, boot txn journal transactionState, extension
  cycle extId diagnostics, boot snapshot schema 2 + provenance
- Offline LKG: BARE_OS_OFFLINE_LKG_ACTIVE / REASON env hints
- Protocol: BARE_OS_PROTOMUX_CHANNEL_SCHEMA_VERSION re-exported from channel.js
- Stubs: corestore suspend/resume register, swarm snapshot, extension resolver,
  initd state enum; shell split note; benchmark/SDK script placeholders
- Docs: ota-channels, conformance-dashboard, kernel-extensions specs index,
  data README; handbook/developer-guide/users-manual cross-links
- Sync packages/bare-os-seeder/kernel with kernel/init.js and STRUCTURE.md
2026-04-04 17:06:35 -04:00

92 lines
4.5 KiB
Markdown

# Chapter 8 — Further reading
**Purpose:** curated entry points after the user manual. **Time to read:** about four minutes.
---
## On this page
- [Architecture and protocol](#architecture-and-protocol)
- [Booter runtime and kernel](#booter-runtime-and-kernel)
- [Extending the system](#extending-the-system)
- [Reference and contracts](#reference-and-contracts)
- [Handbook chapter index](#handbook-chapter-index)
- [Developer guide beyond scripting](#developer-guide-beyond-scripting)
---
## Architecture and protocol
- [Handbook — Preface](../handbook/00-preface.md) — thesis, security limits, contributor paths.
- [Handbook — Chapter 2: Blueprints](../handbook/02-blueprints.md) — layered architecture and trust.
- [Handbook — Chapter 3: Protocol and disk](../handbook/03-protocol-and-disk.md) — MBR, swarm, Protomux, failure modes.
---
## Booter runtime and kernel
- [Handbook — Chapter 4: The booter runtime](../handbook/04-the-booter-runtime.md) — VFS, shell, initd, cron, bridges.
- [Handbook — Chapter 6: Kernel and binaries](../handbook/06-kernel-and-binaries.md) — **`/boot/init.js`**, coreutils pipeline.
- [Developer guide — Kernel: `/boot/init.js`](../developer-guide/03-kernel-boot-init.md) — **`start(ctx)`** and the readline loop.
---
## Extending the system
- [Developer guide — Extending `/bin`](../developer-guide/06-extending-bin-coreutils.md)
- [Developer guide — Kernel + Pear cookbook](../developer-guide/11-kernel-pear-cookbook.md)
- [Developer guide — Bare modules and Pear ecosystem](../developer-guide/12-bare-modules-and-pear-ecosystem.md)
---
## Reference and contracts
- [docs/reference/README.md](../docs/reference/README.md) — index of all reference topics.
- [Compatibility matrix](../docs/reference/compatibility-matrix.md) — ctx API, feature-bits doc, telemetry schema versions.
- [Naming alias matrix](../docs/reference/naming-alias-matrix.md) — legacy ↔ canonical boot hooks and policy keys.
- [Naming migrations](../developer-guide/naming-migrations.md) — deprecation windows for renamed symbols.
- [Capability words](../docs/reference/capability-words.md) — wire layout for **`kernelCapabilityWords`**.
- [Feature roadmap](../docs/reference/feature-roadmap.md) — integration waves and mega-kernel checklists.
- [Environment and POSIX appendix](../docs/reference/environment-and-posix-appendix.md) — exhaustive **`BARE_OS_*`** list and POSIX notes.
- [packages/bare-os-booter/CHANGELOG.md](../packages/bare-os-booter/CHANGELOG.md) — **`bareOsCtxApiVersion`** history.
---
## Handbook chapter index
Read in order for the full narrative, or jump by topic:
- [Preface](../handbook/00-preface.md)
- [1 — Introduction](../handbook/01-introduction.md)
- [2 — Blueprints](../handbook/02-blueprints.md)
- [3 — Protocol and disk](../handbook/03-protocol-and-disk.md)
- [4 — The booter runtime](../handbook/04-the-booter-runtime.md)
- [5 — Identity, vault, and HDMS](../handbook/05-identity-vault-and-hdms.md)
- [6 — Kernel and binaries](../handbook/06-kernel-and-binaries.md)
- [7 — Operations and development](../handbook/07-operations-and-development.md)
- [8 — Git on Bare OS](../handbook/08-git-on-bare-os.md)
- [9 — POSIX utilities, shell, and VFS](../handbook/09-posix-utilities-shell-and-vfs.md)
- [10 — Man pages and online help](../handbook/10-manpages-and-online-help.md)
- [11 — Kernel program and research](../handbook/11-kernel-program-and-research.md)
---
## Developer guide beyond scripting
- [Modules and imports](../developer-guide/05-modules-and-imports.md)
- [Extending `/bin`](../developer-guide/06-extending-bin-coreutils.md)
- [Apps beyond the shell](../developer-guide/07-apps-beyond-the-shell.md)
- [Testing and debugging](../developer-guide/08-testing-and-debugging.md)
- [Security and trust](../developer-guide/09-security-and-trust.md)
- [Glossary and FAQ](../developer-guide/10-glossary-and-faq.md)
- [Kernel + Pear cookbook](../developer-guide/11-kernel-pear-cookbook.md)
- [Bare modules and Pear ecosystem](../developer-guide/12-bare-modules-and-pear-ecosystem.md)
- [Privacy, telemetry, and PII](../developer-guide/13-privacy-telemetry-pii.md)
- [ADR 001 — Kernel feature bit governance](../developer-guide/adr/001-kernel-feature-bits-governance.md)
- [Bare boot / kernel phase alignment](../developer-guide/bare-boot-kernel-phase-alignment.md)
- [Node → Bare module map](../developer-guide/node-to-bare-modules.md)
---
_Previous: [Chapter 7](07-troubleshooting-and-operations.md)_ · _Back to [user manual home](README.md)_