working on more helpful descriptions for flask code examples

mattmakai · mattmakai · commit 034a50ce695e · 2020-07-04T17:06:39.000-04:00
diff --git a/content/pages/examples/flask/flask-app-flask.markdown b/content/pages/examples/flask/flask-app-flask.markdown
@@ -7,7 +7,12 @@ sidebartitle: flask.app Flask
 meta: Python example code for the Flask class from the flask.app module of the Flask project.
 
 
-Flask is a class within the flask.app module of the Flask project.
+[Flask](https://github.com/pallets/flask/blob/master/src/flask/app.py) is
+a class within the flask.app module of the [Flask](/flask.html) framework
+that implements the [WSGI application specification](/wsgi-servers.html).
+This class acts as a central registry for a significant amount of a Flask
+application's functionality, including URL rounting,
+[template configurations](/template-engines.html), and handling view functions.
 
 
 ## Example 1 from Braintree Flask app
diff --git a/content/pages/examples/flask/flask-app-headers.markdown b/content/pages/examples/flask/flask-app-headers.markdown
@@ -7,7 +7,14 @@ sidebartitle: flask.app Headers
 meta: Python example code for the Headers class from the flask.app module of the Flask project.
 
 
-Headers is a class within the flask.app module of the Flask project.
+[Headers](https://github.com/pallets/flask/blob/master/src/flask/app.py)
+is class within the flask.app module of the [Flask](/flask.html)
+[web framework](/web-frameworks.html) that is imported from the
+[datastructures](https://github.com/pallets/werkzeug/blob/master/src/werkzeug/datastructures.py)
+module of the [Werkzeug](https://palletsprojects.com/p/werkzeug/) project.
+Headers handles the
+[HTTP headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)
+from requests and responses for Flask web applications.
 
 
 ## Example 1 from flask-restx
diff --git a/content/pages/examples/flask/flask-blueprints-blueprint.markdown b/content/pages/examples/flask/flask-blueprints-blueprint.markdown
@@ -9,6 +9,10 @@ meta: Python example code for the Blueprint class from the flask.blueprints modu
 
 A Blueprint in [Flask](/flask.html) is
 [a "mold" or template for creating parts of web applications](https://stackoverflow.com/questions/24420857/what-are-flask-blueprints-exactly).
+This
+[Blueprint](https://github.com/pallets/flask/blob/master/src/flask/blueprints.py)
+class within the flask.blueprints module implements that functionality
+for Flask web apps.
 
 
 ## Example 1 from Flask AppBuilder
diff --git a/content/pages/examples/flask/flask-cli-flaskgroup.markdown b/content/pages/examples/flask/flask-cli-flaskgroup.markdown
@@ -7,7 +7,11 @@ sidebartitle: flask.cli FlaskGroup
 meta: Python example code for the FlaskGroup class from the flask.cli module of the Flask project.
 
 
-FlaskGroup is a class within the flask.cli module of the Flask project.
+[FlaskGroup](https://github.com/pallets/flask/blob/master/src/flask/cli.py)
+is a class within the flask.cli module of the Flask project. FlaskGroup
+is a subclass of AppGroup that provides for loading more commands from
+a configured Flask app. Generally, only advanced use cases will need to
+use this class.
 
 
 ## Example 1 from FlaskBB
diff --git a/content/pages/examples/flask/flask-cli-scriptinfo.markdown b/content/pages/examples/flask/flask-cli-scriptinfo.markdown
@@ -7,7 +7,11 @@ sidebartitle: flask.cli ScriptInfo
 meta: Python example code for the ScriptInfo class from the flask.cli module of the Flask project.
 
 
-ScriptInfo is a class within the flask.cli module of the Flask project.
+[ScriptInfo](https://github.com/pallets/flask/blob/master/src/flask/cli.py)
+is a class within the flask.app module of the [Flask](/flask.html)
+framework. It is a helper object for Flask application and not usually
+dealt with directly by developers, instead it is created automatically
+by the [FlaskGroup](/flask-cli-flaskgroup-examples.html) object.
 
 
 ## Example 1 from FlaskBB
