docs: organize docs into sections

[dmitsh]

Reorg the docs to fit fern structure

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[greptile-apps]

Greptile Summary

This PR reorganizes the documentation to fit the Fern docs structure by introducing docs/index.yml as the Fern navigation manifest, trimming README.md to a minimal intro with "Learn more" links, and extracting content into dedicated docs/overview.md and docs/architecture.md pages. All file paths in docs/index.yml resolve correctly, and fern/docs.yml already points at ../docs/index.yml.

Confidence Score: 5/5

Safe to merge — purely a docs reorganization with all links resolving correctly.

All five changed files are documentation only. The Fern navigation index references existing files. The single finding is a P2 style issue (plain-text API.md reference), which does not block merge.

docs/overview.md — one plain-text link reference on line 28 should be a hyperlink.

Important Files Changed

Filename	Overview
README.md	Stripped down to a minimal intro with "Learn more" links pointing correctly to docs/overview.md, docs/architecture.md, and docs/api.md.
docs/index.yml	New Fern navigation file; all referenced paths (overview.md, architecture.md, api.md, providers/, engines/) exist and are correct.
docs/overview.md	New top-level overview page migrated from README; one P2 issue — plain-text "API.md" reference on line 28 should be a hyperlink.
docs/architecture.md	New architecture page; image path assets/design.png resolves correctly relative to docs/architecture.md to docs/assets/design.png.
docs/api.md	Configuration and API reference page; content unchanged, now registered in the Fern navigation index.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["fern/docs.yml"] -->|"path: ../docs/index.yml"| B["docs/index.yml"]
    B --> C["Getting Started"]
    B --> D["Architecture"]
    B --> E["Providers"]
    B --> F["Engines"]
    C --> G["docs/overview.md"]
    D --> H["docs/architecture.md"]
    D --> I["docs/api.md"]
    E --> J["aws / gcp / oci / nebius\ninfiniband / netq / dra"]
    F --> K["slurm / k8s / slinky"]
    L["README.md"] -->|"Learn more"| G
    L -->|"Learn more"| H
    L -->|"Learn more"| I

Loading

_{Reviews (2): Last reviewed commit: "docs: organize docs into sections" | Re-trigger Greptile}