Highlight how to run examples locally

1 files changed, 15 insertions, 0 deletions

diff --git a/book/en/src/by-example.md b/book/en/src/by-example.md
index 84f0019..3a523e5 100644
--- a/book/en/src/by-example.md
+++ b/book/en/src/by-example.md
@@ -15,3 +15,18 @@ Check [the embedded Rust book] for instructions on how to set up an
 embedded development environment that includes QEMU.
 
 [the embedded Rust book]: https://rust-embedded.github.io/book/intro/install.html
+
+To run the examples found in `examples/` locally, cargo needs a supported `target` and
+either `--examples` (run all examples) or `--example NAME` to run a specific example.
+
+Assuming dependencies in place, running:
+
+``` console
+$ cargo run --target thumbv7m-none-eabi --example locals
+```
+
+Yields this output:
+
+``` console
+{{#include ../../../ci/expected/locals.run}}
+```