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 small typos in Client docs #1253

Merged
merged 1 commit into from Apr 22, 2021
Merged

Fix small typos in Client docs #1253

merged 1 commit into from Apr 22, 2021

Conversation

mlodato517
Copy link
Contributor

Just some typos I noticed while reading the docs. Happy to not change any of them!

@@ -53,7 +53,7 @@ use crate::{IntoUrl, Method, Proxy, StatusCode, Url};
/// The `Client` holds a connection pool internally, so it is advised that
/// you create one and **reuse** it.
///
/// You do **not** have to wrap the `Client` it in an [`Rc`] or [`Arc`] to **reuse** it,
/// You do **not** have to wrap the `Client` in an [`Rc`] or [`Arc`] to **reuse** it,
/// because it already uses an [`Arc`] internally.
///
/// [`Rc`]: std::rc::Rc
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'm also not sure if we need this anymore since [Rc] will automatically link to the docs on newer Rust versions. I see we didn't have an explicit link for [Arc] so I wasn't totally sure what to do here.

@@ -172,7 +172,7 @@ impl ClientBuilder {
///
/// # Errors
///
/// This method fails if TLS backend cannot be initialized, or the resolver
/// This method fails if a TLS backend cannot be initialized, or the resolver
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Could also be "the" 🤷

@@ -1003,7 +1003,7 @@ impl Client {
///
/// # Panics
///
/// This method panics if TLS backend cannot initialized, or the resolver
/// This method panics if a TLS backend cannot initialized, or the resolver
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ditto - could also be "the" 🤷

@@ -1023,7 +1023,7 @@ impl Client {
///
/// # Errors
///
/// This method fails whenever supplied `Url` cannot be parsed.
/// This method fails whenever the supplied `Url` cannot be parsed.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I also kind of want to change Url to url or something because, if someone passes an honest-to-goodness Url, I'm guess it can't not be parsed. The issue is if they pass a non-Url url I assume? But that's pretty pedantic (and also maybe wrong).

@mlodato517
Copy link
Contributor Author

mlodato517 commented Apr 22, 2021

Ugh, I was hoping to just do this through GH but there's a typo in my commit message and that seems too embarrassing given the rest of the PR so I'm going to force-push amend that commit as soon as I can clone the repo locally

Done acd31d9

Copy link
Owner

@seanmonstar seanmonstar left a comment

Choose a reason for hiding this comment

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

Thanks so much!

@seanmonstar seanmonstar merged commit b88f309 into seanmonstar:master Apr 22, 2021
@mlodato517 mlodato517 deleted the patch-1 branch April 22, 2021 17:37
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.

None yet

2 participants