Skip to content

docs(contracts): add Rust doc comments to all public contract functions#417

Open
pauljacobb wants to merge 1 commit into
AnnabelJoe:mainfrom
pauljacobb:docs/319-rust-doc-comments
Open

docs(contracts): add Rust doc comments to all public contract functions#417
pauljacobb wants to merge 1 commit into
AnnabelJoe:mainfrom
pauljacobb:docs/319-rust-doc-comments

Conversation

@pauljacobb
Copy link
Copy Markdown

Ensures every public function across all three Soroban contracts has complete /// doc comments covering arguments, authorization, panics, errors, and example invocations.

Changes

  • energy_token: enhanced balance(), total_supply()
  • audit_registry: enhanced anchor(), verify(), api_signer(), admin()
  • community_governance: enhanced set_quorum_bps(), get_quorum_bps(), set_threshold_bps(), get_threshold_bps(), pending_upgrade(), get_execution_timelock(), proposal_count()

Acceptance criteria

  • All public functions in all three contracts have /// doc comments
  • Panics and error conditions documented
  • Example invocations added where helpful

Closes #319

AnnabelJoe#319)

- energy_token: enhanced balance() and total_supply() with examples
- audit_registry: enhanced anchor(), verify(), api_signer(), admin() with
  full Arguments/Errors/Example sections
- community_governance: enhanced set_quorum_bps, get_quorum_bps,
  set_threshold_bps, get_threshold_bps, pending_upgrade,
  get_execution_timelock, proposal_count with Panics/Arguments/Examples

All public functions now have /// doc comments with Panics, Arguments,
Authorization, and example invocations where applicable.

Closes AnnabelJoe#319
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented May 31, 2026

@pauljacobb Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

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 Rust doc comments to all public contract functions

1 participant