[determinator] small update to readme

Minor wording update.

Author: sunshowers

README.md

@@ -5,10 +5,12 @@
 
 This repository contains the source code for:
 * [`guppy`](guppy): a library for performing queries on Cargo dependency graphs [![guppy on crates.io](https://img.shields.io/crates/v/guppy)](https://crates.io/crates/guppy) [![Documentation (latest release)](https://docs.rs/guppy/badge.svg)](https://docs.rs/guppy/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/guppy/)
-* [`guppy-summaries`](guppy-summaries): a library for managing build summaries listing packages and features [![guppy-summaries on crates.io](https://img.shields.io/crates/v/guppy-summaries)](https://crates.io/crates/guppy-summaries) [![Documentation (latest release)](https://docs.rs/guppy-summaries/badge.svg)](https://docs.rs/guppy/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/guppy_summaries/)
-* [`cargo-guppy`](cargo-guppy): a command-line frontend for the `guppy` library [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/cargo_guppy/)
-* [`target-spec`](target-spec): an evaluator for `Cargo.toml` target specifications [![target-spec on crates.io](https://img.shields.io/crates/v/target-spec)](https://crates.io/crates/target-spec) [![Documentation (latest release)](https://docs.rs/target-spec/badge.svg)](https://docs.rs/target-spec/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/target_spec/)
-* [`determinator`](tools/determinator): figure out what packages changed between two revisions [![determinator on crates.io](https://img.shields.io/crates/v/determinator)](https://crates.io/crates/determinator) [![Documentation (latest release)](https://docs.rs/determinator/badge.svg)](https://docs.rs/determinator/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/determinator/)
+* libraries used by guppy:
+  * [`guppy-summaries`](guppy-summaries): a library for managing build summaries listing packages and features [![guppy-summaries on crates.io](https://img.shields.io/crates/v/guppy-summaries)](https://crates.io/crates/guppy-summaries) [![Documentation (latest release)](https://docs.rs/guppy-summaries/badge.svg)](https://docs.rs/guppy/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/guppy_summaries/)
+  * [`target-spec`](target-spec): an evaluator for `Cargo.toml` target specifications [![target-spec on crates.io](https://img.shields.io/crates/v/target-spec)](https://crates.io/crates/target-spec) [![Documentation (latest release)](https://docs.rs/target-spec/badge.svg)](https://docs.rs/target-spec/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/target_spec/)
+* tools built on top of guppy:
+  * [`determinator`](tools/determinator): figure out what packages changed between two revisions [![determinator on crates.io](https://img.shields.io/crates/v/determinator)](https://crates.io/crates/determinator) [![Documentation (latest release)](https://docs.rs/determinator/badge.svg)](https://docs.rs/determinator/) [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/determinator/)
+  * [`cargo-guppy`](cargo-guppy): a command-line frontend for the `guppy` library [![Documentation (master)](https://img.shields.io/badge/docs-master-59f)](https://facebookincubator.github.io/cargo-guppy/rustdoc/cargo_guppy/)
 * and a number of [internal tools](internal-tools) and [test fixtures](fixtures) used to verify that `guppy` behaves correctly.
 
 ## Use cases

tools/determinator/README.md

@@ -199,11 +199,11 @@ dependencies if they're in the same repository.
 
 ## Alternatives and tradeoffs
 
-One way to look at the determinator is through the lens of *cache invalidation*.
-Viewed through this lens, the main purpose of a build or test system is to cache results, and
-[invalidate those caches](https://martinfowler.com/bliki/TwoHardThings.html) based on certain
-parameters. When the determinator marks a package as changed, it invalidates any cached results
-for that package.
+One way to look at the determinator is as a kind of
+[*cache invalidation*](https://martinfowler.com/bliki/TwoHardThings.html). Viewed through this
+lens, the main purpose of a build or test system is to cache results, and invalidate those
+caches based on certain parameters. When the determinator marks a package as changed, it
+invalidates any cached results for that package.
 
 There are several other ways to design caching systems:
 * The caching built into Cargo and other systems like GNU Make, which is based on file
@@ -241,7 +241,7 @@ Facebook's main source repository.
 
 ## Contributing
 
-See the [CONTRIBUTING](../CONTRIBUTING.md) file for how to help out.
+See the [CONTRIBUTING](../../CONTRIBUTING.md) file for how to help out.
 
 ## License
 

tools/determinator/README.tpl

@@ -6,7 +6,7 @@
 
 ## Contributing
 
-See the [CONTRIBUTING](../CONTRIBUTING.md) file for how to help out.
+See the [CONTRIBUTING](../../CONTRIBUTING.md) file for how to help out.
 
 ## License
 

tools/determinator/src/lib.rs

@@ -200,11 +200,11 @@
 //!
 //! # Alternatives and tradeoffs
 //!
-//! One way to look at the determinator is through the lens of *cache invalidation*.
-//! Viewed through this lens, the main purpose of a build or test system is to cache results, and
-//! [invalidate those caches](https://martinfowler.com/bliki/TwoHardThings.html) based on certain
-//! parameters. When the determinator marks a package as changed, it invalidates any cached results
-//! for that package.
+//! One way to look at the determinator is as a kind of
+//! [*cache invalidation*](https://martinfowler.com/bliki/TwoHardThings.html). Viewed through this
+//! lens, the main purpose of a build or test system is to cache results, and invalidate those
+//! caches based on certain parameters. When the determinator marks a package as changed, it
+//! invalidates any cached results for that package.
 //!
 //! There are several other ways to design caching systems:
 //! * The caching built into Cargo and other systems like GNU Make, which is based on file