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: update docs to point to derivation_of_spk #1361

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

15IITian
Copy link

Updated docs of Wallet.is_mine() function to point derivation_of_spk function to find whether a KeychainKind exits for the given script or not.

fix #1042

updated docs to point `derivation_of_spk` function to find whether a `KeychainKind` exits  for the
given `script`

fix bitcoindevkit#1042
@nondiremanuel nondiremanuel added this to the 1.0.0-alpha milestone Feb 27, 2024
Comment on lines 817 to +819
/// Return whether or not a `script` is part of this wallet (either internal or external)
/// Use `derivation_of_spk` function to find the `KeychainKind` for the `script`, or
/// None if there's no associated `Keychain`.
Copy link
Member

Choose a reason for hiding this comment

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

Please follow rust doc conventions. Ref: https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html#documenting-components

We want a separate section for the more detailed description. Also, for clarity, I would reword it like so: "If you wish to find the KeychainKind for the given script, use derivation_of_spk instead."

In addition to this, please have a link for derivation_of_spk.

Copy link
Author

Choose a reason for hiding this comment

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

Would it make sense to have seperate section telling about the derivation_of_spk in detail and include that point ?

@notmandatory notmandatory added documentation Improvements or additions to documentation module-wallet labels Mar 16, 2024
@notmandatory notmandatory modified the milestones: 1.0.0-alpha, 1.0.0-beta Mar 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation module-wallet
Projects
Status: Needs Review
Development

Successfully merging this pull request may close these issues.

The Wallet.is_mine() function should return K
4 participants