docs: clarify repo topology and connected surfaces#1
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the README to clarify where this repository sits in the broader SourceOS/SociOS Linux-side topology, explicitly describing its role as the immutable OS substrate and naming adjacent integration/contract/automation/public-surface repositories.
Changes:
- Added a “Topology position” section describing this repo’s role in the stack.
- Listed connected repositories/surfaces and clarified what is explicitly out of scope for this repo.
- Documented intended semantic direction for publishing a substrate-focused repo descriptor referencing
sourceos-spec.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
@copilot fix failed checks and conflicts |
Agent-Logs-Url: https://github.com/SociOS-Linux/SourceOS/sessions/ffb8b463-6eb1-4ae8-a0a8-ef06d0d25def Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Fixed in bb2adda. The CI was failing due to yamllint errors in |
Summary
Clarifies that
SourceOSis the immutable substrate in the Linux-side topology and names the adjacent integration, contract, automation, and public-surface repos.Why
This repo is central to the stack, but the README did not yet say how it fits with the spine, contract, and commons lanes. This update makes those boundaries explicit.