Add tip for app discovery behavior in quickstart docs

pallets · May 11, 2021 · aa1e48a · aa1e48a
1 parent 3e268f4
commit aa1e48a
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 2 deletions.
diff --git a/docs/cli.rst b/docs/cli.rst
@@ -50,8 +50,8 @@ application, most use cases should be simple. Here are the typical values:
     factory (``create_app`` or ``make_app``).
 
 ``FLASK_APP=hello``
-    The given name is imported, automatically detecting an app (``app`` or
-    ``application``) or factory (``create_app`` or ``make_app``).
+    The given name is imported, automatically detecting an app (``app``
+    or ``application``) or factory (``create_app`` or ``make_app``).
 
 ----
 

diff --git a/docs/quickstart.rst b/docs/quickstart.rst
@@ -70,6 +70,12 @@ to tell your terminal the application to work with by exporting the
          > flask run
           * Running on http://127.0.0.1:5000/
 
+.. admonition:: Application Discovery Behavior
+
+    As a shortcut, if the file is named ``app.py`` or ``wsgi.py``, you
+    don't have to set the ``FLASK_APP`` environment variable. See
+    :doc:`/cli` for more details.
+
 This launches a very simple builtin server, which is good enough for
 testing but probably not what you want to use in production. For
 deployment options see :doc:`deploying/index`.