From 52786de3ed2ff4553378c9b9bca1a60d8b2a2e9d Mon Sep 17 00:00:00 2001 From: Luke Jones Date: Tue, 12 Jan 2016 19:05:03 +1300 Subject: [PATCH] Clarify what a crate is, within the "Getting Started" chapter. * ref: Issue #30825 Small punctuation change in "Crates and Modules". --- src/doc/book/crates-and-modules.md | 2 +- src/doc/book/getting-started.md | 8 +++++--- 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 2b6297640d09f..849c5f1212a57 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 f72737566a493..e9d271e753768 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