about summary refs log tree commit diff
diff options
context:
space:
mode:
authorLuke Jones <luke.nukem.jones@gmail.com>2016-01-12 19:05:03 +1300
committerLuke Jones <luke.nukem.jones@gmail.com>2016-01-15 14:18:50 +1300
commit52786de3ed2ff4553378c9b9bca1a60d8b2a2e9d (patch)
tree6b13e0a88a51c0cd71a198a4a379331e06e731a3
parent2fb0c5ebcf6d912224532265776fb96febea9797 (diff)
downloadrust-52786de3ed2ff4553378c9b9bca1a60d8b2a2e9d.tar.gz
rust-52786de3ed2ff4553378c9b9bca1a60d8b2a2e9d.zip
Clarify what a crate is, within the "Getting Started" chapter.
* ref: Issue #30825
Small punctuation change in "Crates and Modules".
-rw-r--r--src/doc/book/crates-and-modules.md2
-rw-r--r--src/doc/book/getting-started.md8
2 files changed, 6 insertions, 4 deletions
diff --git a/src/doc/book/crates-and-modules.md b/src/doc/book/crates-and-modules.md
index 2b6297640d0..849c5f1212a 100644
--- 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 f72737566a4..e9d271e7537 100644
--- 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