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

feat(iroh): Improve documentation and canonicalize docs in iroh::client #2553

Merged
merged 11 commits into from
Jul 29, 2024

Conversation

matheus23
Copy link
Contributor

@matheus23 matheus23 commented Jul 26, 2024

Description

  • More pointers between individual modules to help people understand how they go from A to B (e.g. Node -> Iroh, Iroh -> blobs::Client, etc.)
  • Documentation on how to initialize client::Iroh
  • Generally make methods adhere to our documentation style.
  • Expose the type alias iroh::client::RpcClient, so it doesn't show up as RpcClient<RpcService, Connection<RpcService>> everywhere it's used in the docs.

Breaking Changes

None, but noteworthy:

  • Expose the type alias iroh::client::RpcClient.

Notes & open questions

Change checklist

  • Self-review.
  • Documentation updates following the style guide, if relevant.
  • [ ] Tests if relevant.
  • All breaking changes documented.

@matheus23 matheus23 self-assigned this Jul 26, 2024
Copy link
Contributor

@flub flub left a comment

Choose a reason for hiding this comment

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

adding a public api is not a breaking change is it?

iroh/src/client/docs.rs Outdated Show resolved Hide resolved
iroh/src/client/docs.rs Show resolved Hide resolved
Copy link

github-actions bot commented Jul 26, 2024

Documentation for this PR has been generated and is available at: https://n0-computer.github.io/iroh/pr/2553/docs/iroh/

Last updated: 2024-07-26T13:54:14Z

@matheus23 matheus23 added this pull request to the merge queue Jul 29, 2024
Merged via the queue into main with commit d937234 Jul 29, 2024
28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

2 participants