Skip to content

docs: the two build modes, and how to switch - #21

Merged
starswallow merged 1 commit into
mainfrom
docs/adaptive-build-modes
Sep 20, 2026
Merged

starswallow merged 1 commit into
mainfrom
docs/adaptive-build-modes

Conversation

@starswallow

Copy link
Copy Markdown
Contributor

Companion to softmata/horus#220. Merge that one first; this page documents commands it adds.

What changed

  • quick-start: a callout at the first build — managed layout, why bare cargo build fails, the shell-integration route, and horus eject / horus new --cargo.
  • depending-on-horus: a "Managed, or cargo-native" section with the decision table and the three ways to switch; the generated-target row now names tests/, examples/, benches/, src/bin/ and the [lib] case.
  • cli-reference: horus eject section and the --cargo flag on horus new.
  • testing: tests/*.rs now runs without a root Cargo.toml.

Validation

  • check:claims, check-links (1168 links), check:mdx (16 expressions/168 files), check_shell_fences (559 blocks), check_toml_fences (79 blocks, schema fresh) — all clean.
  • No schema or frontmatter change, so no llms/schema regeneration.

Companion to softmata/horus#220. A managed project has no manifest cargo can
find at the root, and until now nothing on the getting-started pages said so:
a Rust developer's first `cargo build` failed with `could not find
Cargo.toml` and no explanation.

- quick-start: a callout at the first build naming the managed layout, the
  shell-integration route, and `horus eject` / `horus new --cargo` for a
  manifest cargo owns.
- depending-on-horus: a "Managed, or cargo-native" section with the decision
  table (manifest, plain cargo, horus commands, [rust], horus add), the three
  ways to go cargo-native, and what the shell proxy does; the target-section
  row in the "what horus new generates" table now names tests/examples/
  benches/src/bin and the [lib] case.
- cli-reference: a `horus eject` section (what it writes, what changes after,
  when it refuses) and the `--cargo` flag on `horus new`.
- testing: a tests/ directory runs without a root Cargo.toml now — top-level
  tests/*.rs are declared as targets, nested modules stay helpers.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 20, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
horus-docs be0c410 Sep 20 2026, 08:04 PM

@starswallow
starswallow merged commit bbdc1e2 into main Sep 20, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant