Skip to content

Docs for Odra 2.11 build tooling: test arguments, link_contract_crates, faster builds - #62

Merged
kubaplas merged 2 commits into
masterfrom
docs/2.11-build-tooling
Nov 13, 2026
Merged

kubaplas merged 2 commits into
masterfrom
docs/2.11-build-tooling

Conversation

@kubaplas

@kubaplas kubaplas commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Documents odradev/odra#708, odradev/odra#709 and odradev/cargo-odra#115–#117 in the unreleased docs (docusaurus/docs); the versioned 2.10 docs are not touched. Merge once those are in, as the pages describe Odra 2.11.0 and cargo-odra 0.2.1.

  • Cargo Odra → tests: arguments after -- go to the test binary (-- two, -- --nocapture), arguments for cargo test itself before a second --; a note says what works before cargo-odra 0.2.1 (only the name filter) and how to get --nocapture there.
  • Odra.toml → Linking the other crate (new section): why a dependency's contract needs a reference, odra::link_contract_crates!(), the two cases that still need a use, and the error cargo odra build gives when it is missing. The page did not mention the manual use step at all before.
  • Directory structure: one sentence on the macro line in the build binaries.
  • Building contracts manually: the ODRA_MODULE__<crate> and ODRA_BUILD_PROTOCOL variables cargo odra sets.
  • Migration guide to v2.11.0 (new; the 3.0.0 guide moves one place down in the sidebar): the cargo odra test argument change, the optional macro line, faster builds. It covers these tooling changes only; add other 2.11 changes there as they land.

npm run build passes with no broken links; static/llms.txt gained the new page.

🤖 Generated with Claude Code

kubaplas and others added 2 commits November 13, 2026 11:07
…s, per-crate module variable

- cargo odra test: arguments after -- go to the test binary; Cargo's own before a second --.
- Odra.toml: linking a dependency crate with odra::link_contract_crates!().
- Building manually: the variables cargo odra sets next to ODRA_MODULE.
- Migration guide to 2.11.0.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@kubaplas
kubaplas merged commit 62f1e29 into master Nov 13, 2026
1 check passed
@kubaplas
kubaplas deleted the docs/2.11-build-tooling branch November 13, 2026 12:33
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