Skip to content

docs(StdAssertions, StdInvariant): add NatSpec for public functions#837

Merged
zerosnacks merged 1 commit intofoundry-rs:masterfrom
Ra9huvansh:docs/natspec-assertions-invariant
Mar 26, 2026
Merged

docs(StdAssertions, StdInvariant): add NatSpec for public functions#837
zerosnacks merged 1 commit intofoundry-rs:masterfrom
Ra9huvansh:docs/natspec-assertions-invariant

Conversation

@Ra9huvansh
Copy link
Copy Markdown
Contributor

Adds NatSpec documentation to all public and internal functions in StdAssertions.sol and StdInvariant.sol as part of #653.

Changes:

  • Added @notice to every function describing its behavior
  • Added @param for all parameters
  • Added @return for functions with return values
  • Added @dev for legacy/backwards-compatibility context
  • Added contract-level @notice for both contracts
  • Replaced existing @dev-only comments with @notice + @param/@return in StdInvariant.sol

No logic, interface, or code changes. Comment-only additions.

Copy link
Copy Markdown
Member

@zerosnacks zerosnacks left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@zerosnacks zerosnacks merged commit 50fbb2c into foundry-rs:master Mar 26, 2026
19 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.

2 participants