Note
Every page is deliberately short. If a topic needs a 1000-line essay, it probably belongs upstream in .NET / Blazor / Pages docs, not here.
| I want to… | Go to |
|---|---|
| Understand the module layout | architecture.md |
| Know what CI will run on my PR | ci-cd.md |
| Deploy a new build to the live site | publishing.md |
| Ship a versioned release & self-host archive | releasing.md |
Resync vendored Preflight.Unattend |
upstream-sync.md |
| Add an entry to the changelog | changelog.md |
- Diagrams use Mermaid - GitHub renders them inline.
- Callouts use GitHub's
[!NOTE]/[!TIP]/[!IMPORTANT]/[!WARNING]/[!CAUTION]alerts. - Code samples are copy-paste ready. Shell is
bashunless stated; assumepwdis the repo root. - Paths are always relative to the repo root (e.g.
srcs/Preflight.App/).
| Question | Ask… |
|---|---|
| "How does this component work?" | The source code - these docs don't duplicate API surfaces |
| "When / why did this change?" | git log / commit messages / linked issues |
| "Is this doc out of date?" | The code wins - please open a PR to fix the doc |
Open a PR against the relevant docs/*.md. Keep edits short, truthful,
and current - if you add a paragraph, check whether an older one
became redundant and delete it in the same commit.
← Back to the main README.