1 files changed, 78 insertions, 0 deletions
diff --git a/USE.md b/USE.md
new file mode 100644
index 0000000..81103d6
--- /dev/null
+++ b/USE.md
@@ -0,0 +1,78 @@
+# Using these slippy maps
+
+This project is usable in several ways:
+
+  * Quick - faster to prepare but loads slower into web browser
+  * Compact - compiled for fast and compact hosting
+
+For both approaches the code must be served via a web server
+(loading from filesystem directly into web browser does not work).
+
+
+## Quick
+
+Quick serving is handy during development,
+as changes can be tested without building everything.
+
+
+### Prerequisites
+
+Show needed packages,
+and install them with APT (i.e. as root):
+
+	make list-pkg-code-quick
+	sudo apt install $ABOVE_PACKAGE_LIST
+
+(or install pkglist-code-minimal for a slightly rough visual result)
+
+
+### Serve
+
+Start a tiny webserver,
+and open a web browser at the local address it tells you:
+
+	make serve-quick
+
+
+## Compact
+
+Compact serving is optimized for production use,
+e.g. on a public host served with Apache.
+
+Code and data gets compiled together,
+optimized for the smallest possible size and complexity
+for each single concrete map.
+
+
+### Prerequisites
+
+Show needed packages,
+and install them with APT (i.e. as root):
+
+	make list-pkg-code
+	sudo apt install $ABOVE_PACKAGE_LIST
+
+
+### Build
+
+To build functional site but skip image fetching:
+
+    make build-compact
+
+To build everything, including image fetching:
+
+    make
+
+
+### Serve
+
+Start a tiny webserver,
+and open a web browser at the local address it tells you:
+
+	make serve-quick
+
+For production use,
+consider to instead setup e.g. Apache to serve <build> directory.
+The <build> directory is fully self-contained
+(contain no symlinks to or html links to system-wide code)
+so can be copied to an external web hosting provider.