Update tooling.md #166
Update tooling.md #166
Conversation
|
r? @japaric (rust_highfive has picked a reviewer for you, use r? to override) |
rust-highfive
added
S-waiting-on-review
|
|
||
| The text below explains why we are using these tools. Installation instructions | ||
| can be found on the next page. | ||
|
|
||
| ## `cargo-generate` OR `git` | ||
|
|
||
| ## Using a template for the first project ## |
There was a problem hiding this comment.
All headings are named after tools. With this change that would no longer be the case. I would prefer to keep the symmetry.
There was a problem hiding this comment.
What about cargo-generate and other tools ?
There was a problem hiding this comment.
By the way, maybe write something about rustc too ..
There was a problem hiding this comment.
The current text matches what's listed in the bullet list. The "other tools" in your proposal makes it unclear whether "other tools" means just git or all / some of the other tools in the bullet list.
Personally, I think the current text is fine.
There was a problem hiding this comment.
By the way, maybe write something about rustc too ..
Rust developers (the target audience of this book) are familiar with rustc / Cargo; I don't think it's necessary to add a section for them.
There was a problem hiding this comment.
i just find it strange that the choice now is between cargo generate and git both tools need to be downloaded and installed, while the other tools "curl, wget, or your web browser." are likely to be already on a system. But i'm tired to bike shed over this, so you can get the final call, i'll leave it as it is or make it whatever.
| - [OPTIONAL] `git` OR | ||
| [`cargo-generate`](https://github.com/ashleygwilliams/cargo-generate). If you | ||
| have neither installed then don't worry about installing either. | ||
| - [`cargo-generate`](https://github.com/ashleygwilliams/cargo-generate) and `git`. |
There was a problem hiding this comment.
Actually, this should be "(..) or git". You don't need both tools; one of them suffices.
There was a problem hiding this comment.
Later on in the book cargo generate --git command is used. We can put or here when comes with it's own git api and doesn't rely on standalone git. I assumed it relies on standalone git.
There was a problem hiding this comment.
From this wording i conclude that standalone git is not required https://github.com/rust-lang/git2-rs#version-of-libgit2 (dependency of cargo generate)
There was a problem hiding this comment.
cargo-generate doesn't shell out to git; it uses libgit.
|
@flip111, in that case let's leave the text as it is. Could you please close the two issues you linked from here? Thanks. |
|
I was referring to line 24 which you commented on. Since this PR is now closed i opened a new PR with only the pieces that didn't get negative feedback. #172 I will close the second issue later |
#134