Skip to content

docs: add Rustdoc for public contract API#317

Merged
mikewheeleer merged 1 commit into
StableRoute-Org:mainfrom
bukeeastrey:test/contracts-error-code-uniqueness
Jul 24, 2026
Merged

docs: add Rustdoc for public contract API#317
mikewheeleer merged 1 commit into
StableRoute-Org:mainfrom
bukeeastrey:test/contracts-error-code-uniqueness

Conversation

@bukeeastrey

Copy link
Copy Markdown
Contributor

Summary

Adds comprehensive Rustdoc documentation for the StableRoute router's public contract API.

What was done

  • Added Rustdoc comments to public contract entrypoints
  • Documented authorization requirements for admin- and oracle-gated methods
  • Documented default return values and storage behavior for getters
  • Explained important invariants, limits, and edge cases where applicable
  • Added cross-references between related APIs using Rustdoc links

Why

Improves the self-documentation of the contract, making the public API easier to understand for developers integrating with StableRoute while also improving generated documentation.

Closes #217

@mikewheeleer

Copy link
Copy Markdown
Contributor

well done @bukeeastrey, this reads well. merging in 🌟

@mikewheeleer
mikewheeleer merged commit aa35d21 into StableRoute-Org:main Jul 24, 2026
2 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.

Add a test asserting every RouterError discriminant is unique

2 participants