update examples docs

Author: thnee

docs/examples.rst

@@ -4,6 +4,13 @@ Examples
 Example apps demonstrating usage.
 
 
+Complete examples
+-----------------
+
+Please see the `examples`_ directory in the repo for more examples,
+including complete project packages with application factory pattern and blueprints.
+
+
 Minimal example without database
 --------------------------------
 
@@ -18,3 +25,6 @@ Minimal example with database
 .. literalinclude:: ../examples/minimal_db/main.py
    :language: python
    :caption: examples/minimal_db/main.py
+
+
+.. _examples: https://github.com/thnee/flask-api-framework/tree/main/examples

examples/README.rst

@@ -0,0 +1,38 @@
+Examples
+========
+
+Example apps demonstating usage.
+
+Note: The examples also have tests located in `../tests/examples`,
+they are run as part of the main test suite for the whole project.
+
+
+Examples description
+--------------------
+
+minimal_db
+^^^^^^^^^^
+
+Minimal example using sqlalchemy.
+
+.. code-block:: text
+
+    FLASK_APP=minimal_db:app flask run
+
+minimal_nodb
+^^^^^^^^^^^^
+
+Minimal example without using sqlalchemy or marshmallow-sqlalchmy.
+
+.. code-block:: text
+
+    FLASK_APP=minimal_nodb:app flask run
+
+complete_db
+^^^^^^^^^^^
+
+Complete example project using sqlalchemy and marshmallow-sqlalchemy.
+
+.. code-block:: text
+
+    FLASK_APP=complete_db.app flask run