Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix cargo doc #1788

Merged
merged 7 commits into from
Feb 17, 2022
Merged

Fix cargo doc #1788

merged 7 commits into from
Feb 17, 2022

Conversation

soareschen
Copy link
Contributor

@soareschen soareschen commented Jan 18, 2022

Closes: #1776

Description

Todo:

  • Fix cargo doc errors.
  • Fix cargo doc warnings.
  • Add CI to check for cargo doc.

PR author checklist:

  • Added changelog entry, using unclog.
  • Added tests: integration (for Hermes) or unit/mock tests (for modules).
  • Linked to GitHub issue.
  • Updated code comments and documentation (e.g., docs/).

Reviewer checklist:

  • Reviewed Files changed in the GitHub PR explorer.
  • Manually tested (in case integration/unit/mock tests are absent).

@soareschen soareschen marked this pull request as ready for review February 16, 2022 11:56
.github/workflows/cargo-doc.yaml Outdated Show resolved Hide resolved
Comment on lines 154 to 155
/// [`tendermint_light_client_verifier::options::Options`] struct for use in
/// Tendermint-specific light client verification.
Copy link
Contributor

Choose a reason for hiding this comment

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

It would be better to shorten the text in the link:

    /// [`Options`] struct for use in Tendermint-specific light client verification.
    /// [`Options`]: tendermint_light_client_verifier::options::Options

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hmm I tried and it don't seem like this style of link shortening works in Rustdoc.

Comment on lines +2 to +4
//! [`ChainHandle`](crate::chain::handle::ChainHandle) can accept.
//! These types trickle down to the
//! [`ChainEndpoint`](crate::chain::ChainEndpoint) trait.
Copy link
Contributor

Choose a reason for hiding this comment

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

Good, but stylistically footnote-style markup reads better in code, like in my suggestion above.

@romac romac merged commit f1a4481 into master Feb 17, 2022
@romac romac deleted the soares/fix-cargo-doc branch February 17, 2022 12:36
hu55a1n1 pushed a commit to hu55a1n1/hermes that referenced this pull request Sep 13, 2022
* Fix cargo doc errors

* Fix cargo doc

* Add CI for cargo doc

* Fix cargo doc

* Fix Markdown link

* Fix review feedback
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.

IBC integration test suite documentation does not build
3 participants