add a note to the README about this being a tutorial for an ancient version of Rust
[rust-101.git] / README.md
index e7068ac86a7a95075a2575c674397180b7e81904..c163e7f6c1b67d57c529e5800e7a844e84c6bfd2 100644 (file)
--- a/README.md
+++ b/README.md
@@ -3,6 +3,9 @@
 This documents Rust-101, a tutorial for the [Rust
 language](http://www.rust-lang.org/).
 
 This documents Rust-101, a tutorial for the [Rust
 language](http://www.rust-lang.org/).
 
+**Note that this tutorial was written for Rust 1.3 in 2015, and the language evolved a lot since then.
+Some of the idioms presented here may no longer reflect current practice.**
+
 ## Online tutorial
 
 The most accessible form of the tutorial is its
 ## Online tutorial
 
 The most accessible form of the tutorial is its
@@ -11,8 +14,8 @@ The most accessible form of the tutorial is its
 ## Offline Usage
 
 You can either read through the sources in `src/`, or generate the
 ## 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/)).
+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`.
 
 
 The files `workspace/src/part*.rs` are generated by `make workspace`.