guideXOS Server Contributor Notes
Purpose: help contributors get oriented quickly and describe work honestly.
Start with the right mental model
- guideXOS Server is its own guideXOS branch.
- Do not confuse it with guideXOS C# documentation or assumptions.
- Treat the native/multi-architecture repo as the primary source of truth for this branch.
- Keep hosted and bare-metal testing in mind when changing UI, app-model, boot, or storage behavior.
Current status: contributor guidance for an active development branch.
Known gaps: documentation breadth is still growing and some areas remain roadmap-heavy.
Back to /Wiki/Server
What to read first
README.mdfor branch framing and major repo layoutdocs/BUILD_GUIDE.mdfor the build/run scriptsserver.cppfor the hosted system-server roleguideXOSBootLoader/main.cppandkernel/core/main.cppfor boot and kernel responsibilitiesdocs/APP_MODEL_CURRENT_STATE.mdfor the app-model split
How to describe status honestly
- Implemented: source and current behavior clearly support the claim.
- Partial: pieces exist, but parity, integration, or breadth is incomplete.
- Experimental: feature exists behind constraints, narrow validation, or bring-up tooling.
- Planned: documented direction or enum/design surface, but not a finished runtime path.
- Not yet verified: possible from source shape, but not proven enough for a stronger statement.