From e9d5c81f164c14f825727664a5ebf2dd16b7b3fc Mon Sep 17 00:00:00 2001
From: AcuGIS <acugis@noreply.localhost>
Date: Wed, 10 Jul 2024 16:27:23 +0000
Subject: [PATCH] Add docs/source/install.rst

---
 docs/source/install.rst | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 docs/source/install.rst

diff --git a/docs/source/install.rst b/docs/source/install.rst
new file mode 100644
index 0000000..826ba75
--- /dev/null
+++ b/docs/source/install.rst
@@ -0,0 +1,37 @@
+Install
+=====
+
+.. _installation:
+
+Installation
+------------
+
+To use Lumache, first install it using pip:
+
+.. code-block:: console
+
+    $ hostnamectl set-hostname qpod.webgis1.com
+	$ git clone https://github.com/AcuGIS/quartzmap.git
+	$ cd quartzmap
+	$ ./installer/postgres.sh
+	$ ./installer/app-install.sh
+
+More
+----------------
+
+To retrieve a list of random ingredients,
+you can use the ``lumache.get_random_ingredients()`` function:
+
+.. autofunction:: lumache.get_random_ingredients
+
+The ``kind`` parameter should be either ``"meat"``, ``"fish"``,
+or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients`
+will raise an exception.
+
+.. autoexception:: lumache.InvalidKindError
+
+For example:
+
+>>> import lumache
+>>> lumache.get_random_ingredients()
+['shells', 'gorgonzola', 'parsley']