doc(examples): readme

1 files changed, 31 insertions, 0 deletions

diff --git a/examples/README.rst b/examples/README.rst
new file mode 100644
index 0000000..0aa3baa
--- /dev/null
+++ b/examples/README.rst
@@ -0,0 +1,31 @@
+Examples
+========
+
+Build
+-----
+
+Build All Examples
+^^^^^^^^^^^^^^^^^^
+
+To build all of the available examples, execute:
+
+.. code-block:: shell
+
+  $ divina build
+
+The resulting objects and binaries will be placed into the :code:`out/` directory.
+
+Build a Single Example
+^^^^^^^^^^^^^^^^^^^^^^
+
+To build a single example:
+
+1. :code:`cd` into an example directory:
+
+   .. code-block:: shell
+   
+     cd examples/greet/
+ 
+2. :code:`$ divina build`
+
+The resulting object(s) and binary will be placed into the :code:`out/` directory.