Merge pull request #42 from zdyxry/master
[rust-101.git] / README.md
index 7895b8b94e5c6186e74b9a4f733db79f667e6dbe..494099fd94eebaee3c068601dd48b63d147d9664 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,16 +1,18 @@
 # Rust-101
 
 This documents Rust-101, a tutorial for the [Rust
-language](http://www.rust-lang.org/). You are probably looking for the
-[actual tutorial](https://www.ralfj.de/projects/rust-101/main.html).
+language](http://www.rust-lang.org/).
 
+## Online tutorial
 
-## Usage
+The most accessible form of the tutorial is its
+[online version](https://www.ralfj.de/projects/rust-101/main.html).
+
+## Offline Usage
 
 You can either read through the sources in `src/`, or generate the
-HTML in `docs/` using `make docs` (this step needs
-[Pycco](https://fitzgen.github.io/pycco/)), or go directly to [the
-rendered output](https://www.ralfj.de/projects/rust-101/main.html).
+HTML in `docs/` using `make docs`. This steps assumes `pipx install pycco` has
+been run before; it will use the pipx-created venv to import pycco.
 
 The files `workspace/src/part*.rs` are generated by `make workspace`.