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

docs: wallet type docstrings #616

Merged
merged 1 commit into from
Nov 26, 2024
Merged

Conversation

reez
Copy link
Collaborator

@reez reez commented Oct 31, 2024

Description

Adding some additional docstrings for Wallet

// ------------------------------------------------------------------------
// bdk_wallet crate - types module
// ------------------------------------------------------------------------

Notes to the reviewers

Changelog notice

Checklists

All Submissions:

  • I've signed all my commits
  • I followed the contribution guidelines
  • I ran cargo fmt and cargo clippy before committing

New Features:

  • I've added tests for the new feature
  • I've added docs for the new feature

Bugfixes:

  • This pull request breaks the existing API
  • I've added tests to reproduce the issue which are now passing
  • I'm linking the issue being fixed by this PR

@reez reez changed the title (draft) docs: wallet type docstrings docs: wallet type docstrings Nov 5, 2024
@reez reez force-pushed the docstrings-more branch 2 times, most recently from ff247a3 to 4ac00ac Compare November 21, 2024 23:32
@reez reez marked this pull request as ready for review November 21, 2024 23:32
@reez
Copy link
Collaborator Author

reez commented Nov 21, 2024

rebased, updated to reflect current standard for docstrings, ready for review-

@reez reez requested a review from thunderbiscuit November 21, 2024 23:37
Copy link
Member

@thunderbiscuit thunderbiscuit left a comment

Choose a reason for hiding this comment

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

Two small comments and a rebase.

@@ -374,6 +416,7 @@ dictionary CanonicalTx {
ChainPosition chain_position;
};

/// Builds a [`FullScanRequest`].
Copy link
Member

Choose a reason for hiding this comment

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

These links don't work in the KDocs. I'll send you a screenshot of what they look like, but I was thinking of removing them.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Discussed on the Bindings Call to just re-visit this topic in a few months

dictionary AddressInfo {
/// Child index of this address
Copy link
Member

Choose a reason for hiding this comment

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

I think the standard for Rust and Kotlin/Java is to have a full stop at the end of the first sentence, even if there is only one. I noticed that it's not always respected in the bdk docs, but then added when people point them out. In case the Rust docs are faulty of this, I suggest we simply fix here for the ffi docs.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Discussed on the Bindings Call to just re-visit this topic in a few months

@reez
Copy link
Collaborator Author

reez commented Nov 26, 2024

rebased, should be good to go.

@thunderbiscuit
Copy link
Member

Feel free to merge this is ready to go.

Copy link
Member

@thunderbiscuit thunderbiscuit left a comment

Choose a reason for hiding this comment

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

ACK cf5f714.

@reez reez merged commit cf5f714 into bitcoindevkit:master Nov 26, 2024
25 checks passed
@reez reez deleted the docstrings-more branch November 26, 2024 18:38
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