Change: make examples more prominent

1 files changed, 18 insertions, 3 deletions

diff --git a/index.mdwn b/index.mdwn
index da67cf2..ee3917e 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -42,9 +42,24 @@ to abide by its terms.
 
 ## Examples
 
-See the [examples][] site for examples.
-These are generated automatically from the Subplot source repository
-by CI, so they're always up to date.
+See actual, working, tested examples:
+
+* The Unix echo command
+  ([html](https://examples.subplot.liw.fi/echo.html),
+  [PDF](https://examples.subplot.liw.fi/echo.pdf)).
+
+* A hypothetical JSON store with access control and a web API
+  ([html](https://examples.subplot.liw.fi/muck.html),
+  [PDF](https://examples.subplot.liw.fi/muck.pdf)).
+
+* Subplot's own acceptance criteria, a non-trivial example
+  ([html](https://examples.subplot.liw.fi/subplot.html)
+  [PDF](https://examples.subplot.liw.fi/subplot.pdf)) .
+
+The [examples][] site may have more examples, if we forget to list
+them here. These are generated automatically from the Subplot source
+repository by CI, so they're always up to date, and tested as part of
+Subplot's CI build, so they always work.
 
 [examples]: https://examples.subplot.liw.fi/