Clarify what a crate is, within the "Getting Started" chapter.

* ref: Issue #30825
Small punctuation change in "Crates and Modules".

diff --git a/src/doc/book/crates-and-modules.md b/src/doc/book/crates-and-modules.md
index 2b6297640d09faab59f7edbd6786602ba026ee85..849c5f1212a571f8da422c5c775b9b174b84ed5a 100644 (file)
--- a/src/doc/book/crates-and-modules.md
+++ b/src/doc/book/crates-and-modules.md
@@ -2,7 +2,7 @@
 
 When a project starts getting large, it’s considered good software
 engineering practice to split it up into a bunch of smaller pieces, and then
-fit them together. It’s also important to have a well-defined interface, so
+fit them together. It is also important to have a well-defined interface, so
 that some of your functionality is private, and some is public. To facilitate
 these kinds of things, Rust has a module system.
 

diff --git a/src/doc/book/getting-started.md b/src/doc/book/getting-started.md
index f72737566a493a7dccfec64ca79eda27cffd41d6..e9d271e7537685b299cc710ecf8ed9fc1c5460b1 100644 (file)
--- a/src/doc/book/getting-started.md
+++ b/src/doc/book/getting-started.md
@@ -505,9 +505,11 @@ Cargo checks to see if any of your project’s files have been modified, and onl
 rebuilds your project if they’ve changed since the last time you built it.
 
 With simple projects, Cargo doesn't bring a whole lot over just using `rustc`,
-but it will become useful in future. With complex projects composed of multiple
-crates, it’s much easier to let Cargo coordinate the build. With Cargo, you can
-run `cargo build`, and it should work the right way.
+but it will become useful in future. This is especially true when you start
+using crates; these are synonymous with a ‘library’ or ‘package’ in other
+programming languages. For complex projects composed of multiple crates, it’s
+much easier to let Cargo coordinate the build. Using Cargo, you can run `cargo
+build`, and it should work the right way.
 
 ## Building for Release