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.md for branch framing and major repo layout
  • docs/BUILD_GUIDE.md for the build/run scripts
  • server.cpp for the hosted system-server role
  • guideXOSBootLoader/main.cpp and kernel/core/main.cpp for boot and kernel responsibilities
  • docs/APP_MODEL_CURRENT_STATE.md for 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.