Skip to content

Docs: Update README for library#28

Merged
ValuedMammal merged 4 commits intobitcoindevkit:masterfrom
tvpeter:docs/update-readme
Apr 2, 2026
Merged

Docs: Update README for library#28
ValuedMammal merged 4 commits intobitcoindevkit:masterfrom
tvpeter:docs/update-readme

Conversation

@tvpeter
Copy link
Copy Markdown
Collaborator

@tvpeter tvpeter commented Feb 3, 2026

Description

This PR updates the Readme for the library. It also adds project License files.

Checklists

All Submissions:

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

Copy link
Copy Markdown
Collaborator

@oleonardolima oleonardolima left a comment

Choose a reason for hiding this comment

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

cACK

@ValuedMammal
Copy link
Copy Markdown
Collaborator

This looks great.

In 699fafc - docs: Update README for the library

For code blocks you should include the language to enable syntax highlighting. Note that for toml files comments are denoted with #.

- Add syntax highlighting for code blocks in
README
Comment on lines +76 to +83
## License

Licensed under either of

* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or <https://www.apache.org/licenses/LICENSE-2.0>)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or <https://opensource.org/licenses/MIT>)

at your option.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

There's no Apache-2.0 License in this PR or the repo.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Should have a LICENSE-MIT, LICENSE-APACHE and a LICENSE.md (so GH renders it).

Copy link
Copy Markdown
Collaborator

@ValuedMammal ValuedMammal left a comment

Choose a reason for hiding this comment

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

ACK 1da987e fixed sentence spacing and missing backtick in docs.

--- a/src/client.rs
+++ b/src/client.rs
@@ -107,11 +107,11 @@ impl Client {
         Self {
             inner: jsonrpc::Client::with_transport(transport),
         }
     }
 
-    /// Calls the underlying RPC `method` with the given`args`.
+    /// Calls the underlying RPC `method` with the given `args`.
     ///
     /// This is the generic function used by all specific RPC methods.
     pub fn call<T>(&self, method: &str, args: &[serde_json::Value]) -> Result<T, Error>
     where
         T: for<'de> serde::Deserialize<'de>,
@@ -160,11 +160,11 @@ impl Client {
             .0
             .try_into()
             .map_err(Error::TryFromInt)
     }
 
-    /// Retrieves the ['BlockHash'] of the block at `height`.
+    /// Retrieves the [`BlockHash`] of the block at `height`.
     ///
     /// # Arguments
     ///
     /// * `height`: The block height
     ///

@ValuedMammal
Copy link
Copy Markdown
Collaborator

reACK 1d89d3c

@luisschwab
Copy link
Copy Markdown
Member

@ValuedMammal we don't have the actual LICENSE-APACHE, LICENSE-MIT and LICENSE.md files here yet.

@ValuedMammal ValuedMammal requested a review from luisschwab April 2, 2026 00:55
@luisschwab
Copy link
Copy Markdown
Member

@ValuedMammal we don't have the actual LICENSE-APACHE, LICENSE-MIT and LICENSE.md files here yet.

I meant that these should be added in this PR.

@tvpeter tvpeter self-assigned this Apr 2, 2026
@luisschwab
Copy link
Copy Markdown
Member

@tvpeter can you rename LICENSE to LICENSE.md? Otherwise GitHub won't render the Markdown links.

@tvpeter tvpeter force-pushed the docs/update-readme branch from 22f0f6e to 8c70226 Compare April 2, 2026 04:01
LICENSE.md Outdated
Comment on lines +7 to +10
Except as otherwise noted in individual files, all files in this repository are
licensed under the Apache License, Version 2.0 <[Apache 2.0](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0> or the MIT license <[MIT](LICENSE-MIT) or
http://opensource.org/licenses/MIT>, at your option.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
Except as otherwise noted in individual files, all files in this repository are
licensed under the Apache License, Version 2.0 <[Apache 2.0](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0> or the MIT license <[MIT](LICENSE-MIT) or
http://opensource.org/licenses/MIT>, at your option.
Except as otherwise noted in individual files, all files in this repository are
licensed under the Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
<http://www.apache.org/licenses/LICENSE-2.0>) or the MIT License ([LICENSE-MIT](LICENSE-MIT) or
<http://opensource.org/licenses/MIT>), at your option.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Should the link title (LICENSE-APACHE, LICENSE-MIT) be uniform everywhere? In Readme and at the top of LICENSE.md?

@tvpeter tvpeter force-pushed the docs/update-readme branch from 8c70226 to 01facc5 Compare April 2, 2026 05:12
@luisschwab
Copy link
Copy Markdown
Member

@tvpeter your latest push is not quite right. Compare it against my last review.

@tvpeter tvpeter force-pushed the docs/update-readme branch from 01facc5 to 8bf074a Compare April 2, 2026 13:18
@tvpeter
Copy link
Copy Markdown
Collaborator Author

tvpeter commented Apr 2, 2026

@tvpeter your latest push is not quite right. Compare it against my last review.

Seen it and fixed. Thank you.

Copy link
Copy Markdown
Member

@luisschwab luisschwab left a comment

Choose a reason for hiding this comment

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

ACK 8bf074a

@ValuedMammal
Copy link
Copy Markdown
Collaborator

ACK

@ValuedMammal ValuedMammal merged commit f5fce39 into bitcoindevkit:master Apr 2, 2026
8 checks passed
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.

5 participants