miles/docs/developer/index.md

title, sidebarTitle, description

title	sidebarTitle	description
Developer Guide	Overview	Contribution conventions, internal architecture, dependency versions, and debugging.

You're here because you want to change Miles, not just use it. This section is the short tour for new contributors.

Repo layout, what enforces code style, what lives in .claude, and how to drive CI from a PR.

The 30-minute tour of how Miles is organized internally.

How the miles, SGLang and Megatron-LM trees fit together, and how to bump one.

Isolating rollout from training, the debug and CI assertion flags, aligning precision.

Megatron-LM and FSDP: what each backend owns and where its code lives.

TL;DR for first-time contributors

1. Pick something small from good first issue on GitHub.
2. Run the Reproducibility recipe so you can be sure "I changed X and it broke" actually means that.
3. Use --debug-train-only or --debug-rollout-only to scope your changes.
4. Open a PR. We'll review within ~48h.