From 7a7a182bda4fbdab1bc0efe9d7968833e38e6f1f Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@edbob.org>
Date: Tue, 19 Jan 2021 12:50:23 -0600
Subject: [PATCH] Add basic Quick Start guide

---
 docs/index.rst      |  1 +
 docs/quickstart.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 docs/quickstart.rst

diff --git a/docs/index.rst b/docs/index.rst
index 0307d14..5b393f9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -36,6 +36,7 @@ this document.
    :caption: Contents:
 
    readfirst
+   quickstart
    background
    base/index
    data/index
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
new file mode 100644
index 0000000..c871472
--- /dev/null
+++ b/docs/quickstart.rst
@@ -0,0 +1,40 @@
+
+.. highlight:: sh
+
+Quick Start
+===========
+
+This should get you up and running with a custom Rattail app within minutes.
+(For a more thorough treatment see the `Rattail Tutorial`_.)
+
+.. _Rattail Tutorial: https://rattailproject.org/docs/rattail-tutorial/
+
+Go to the `Rattail Demo`_ and generate a new "rattail" type project.  You must
+login to get access; use "chuck" / "admin" for credentials.
+
+.. _Rattail Demo: https://demo.rattailproject.org/generate-project
+
+Name your project whatever you like.  The default is "Okay-Then" so we'll
+assume that here.  You should download a zip file, e.g. ``okay-then.zip`` which
+contains the project files.  Extract it somewhere convenient; we'll use
+``~/src/okay-then``::
+
+   mkdir -p ~/src
+   unzip ~/Downloads/okay-then.zip -d ~/src
+
+Your local PostgreSQL service should be available, and user (named ``rattail``)
+and DB (named ``okay-then``) created::
+
+   sudo apt install postgresql
+   sudo -u postgres createuser -P rattail
+   sudo -u postgres createdb -O rattail okay-then
+
+Make and activate a virtual environment; e.g. ``/srv/envs/okay-then``::
+
+   mkdir -p /srv/envs
+   python -m venv /srv/envs/okay-then
+   source /srv/envs/okay-then/bin/activate
+
+With the virtual environment active, run the development bootstrap script::
+
+   python ~/src/okay-then/dev/bootstrap.py