Shape library documentation editing

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/README.md b/README.md
index 9449d8679a05d6771d36525670bbaf709cc96de6..08d53e0e2cf06a49a30d542178bc47c9e5a24d50 100644 (file)
--- a/README.md
+++ b/README.md
@@ -82,8 +82,14 @@ ADDING SHAPES
 Otter uses SVGs.  The sources for the SVGs are all in the otter source
 tree, in the `library/` directory.
 
-Unfortunately the mechanisms here are not yet particularly well
-documented.
+Each shape is listed in one of the `library/*.toml` files, in a
+`files` entry.  Unfortunately the syntax and semantics of this file
+are not yet properly documented.
+
+You can preview the shapes, including any changes you make, without a
+whole game server, by running `make -j8 shapelib`, and looking at
+`templates/shapelib.html`.  (See BUILDING AND TESTING for information
+about how to install the tools you will need.)
 
 Some of these SVGs were scraped from Wikimedia.  The scraper machinery
 can perhaps be adapted to scrape SVGs from elsewhere.
@@ -107,6 +113,7 @@ internet connection.  Your computer will be compiling a lot of code.
 
 These instructions have been tested on Debian buster.
 
+
 Setup
 -----
 
@@ -141,6 +148,11 @@ Setup
      rustup default nightly-2020-11-09
 ```
 
+
+** If you just want to edit and preview the shape libraries
+   (ie the piece shapes) you can stop here **
+
+
 4. Install some build tools:
 
 ```
@@ -173,6 +185,13 @@ Build
      make -j8 all bundled-sources
 ```
 
+Or if you just want to edit the piece libraries:
+
+```
+    make -j8 shapelib
+```
+And then open ./templates/shapelib.html in your browser
+
 
 Ad-hoc tests
 ------------