update flask descriptions

mattmakai · mattmakai · commit bf57a4ca08de · 2020-07-09T20:38:46.000-04:00
diff --git a/content/pages/examples/flask/flask-json-jsonencoder.markdown b/content/pages/examples/flask/flask-json-jsonencoder.markdown
@@ -7,7 +7,12 @@ sidebartitle: flask.json JSONEncoder
 meta: Example code for understanding how to use the JSONEncoder class from the flask.json module of the Flask project.
 
 
-JSONEncoder is a class within the flask.json module of the Flask project.
+[JSONEncoder](https://github.com/pallets/flask/blob/master/src/flask/json/__init__.py)
+is a class within the [Flask](/flask.html) project under the `flask.json`
+module. `JSONEncoder` is the default [JSON](https://www.json.org/json-en.html)
+encoder for Flask and was designed to handle more types than Python's
+standard library [json](https://docs.python.org/3/library/json.html) module.
+
 
 
 ## Example 1 from Flask-Security-Too
diff --git a/content/pages/examples/flask/flask-json-jsonify.markdown b/content/pages/examples/flask/flask-json-jsonify.markdown
@@ -7,7 +7,17 @@ sidebartitle: flask.json jsonify
 meta: Python example code that shows how to use the jsonify callable from the flask.json module of the Flask project.
 
 
-jsonify is a callable within the flask.json module of the Flask project.
+[jsonify](https://github.com/pallets/flask/blob/master/src/flask/json/__init__.py)
+is a function in [Flask](/flask.html)'s `flask.json` module. `jsonify`
+serializes data to
+[JavaScript Object Notation (JSON)](https://www.json.org/json-en.html) format,
+wraps it in a
+[Response](https://blog.miguelgrinberg.com/post/customizing-the-flask-response-class)
+object with the application/json mimetype.
+
+Note that `jsonify` is sometimes imported directly from the `flask` module
+instead of from `flask.json`. It is the same function that is imported, but
+there are less characters to type when you leave off the `.json` part.
 
 
 ## Example 1 from Flask AppBuilder
diff --git a/content/pages/examples/flask/flask-sessions-badsignature.markdown b/content/pages/examples/flask/flask-sessions-badsignature.markdown
@@ -7,7 +7,11 @@ sidebartitle: flask.sessions BadSignature
 meta: Example code for understanding how to use the BadSignature class from the flask.sessions module of the Flask project.
 
 
-BadSignature is a class within the flask.sessions module of the Flask project.
+[BadSignature](https://github.com/pallets/flask/blob/master/src/flask/sessions.py)
+is a class often imported into [Flask](/flask.html) applications from
+the `flask.sessions` module. `BadSignature` is actually defined in the
+[itsdangerous](https://github.com/pallets/itsdangerous) project and
+imported into Flask sessions for applications to use.
 
 
 ## Example 1 from FlaskBB
diff --git a/content/pages/examples/flask/flask-sessions-sessioninterface.markdown b/content/pages/examples/flask/flask-sessions-sessioninterface.markdown
@@ -7,7 +7,10 @@ sidebartitle: flask.sessions SessionInterface
 meta: Example code for understanding how to use the SessionInterface class from the flask.sessions module of the Flask project.
 
 
-SessionInterface is a class within the flask.sessions module of the Flask project.
+[SessionInterface](https://github.com/pallets/flask/blob/master/src/flask/sessions.py)
+is a class used with [Flask](/flask.html) projects that is defined in
+the `flask.sessions` module. `SessionInterface` is the basic interface
+that must be implemented to replace the default session interface.
 
 
 ## Example 1 from tedivms-flask
diff --git a/content/pages/examples/flask/flask-sessions-sessionmixin.markdown b/content/pages/examples/flask/flask-sessions-sessionmixin.markdown
@@ -7,7 +7,12 @@ sidebartitle: flask.sessions SessionMixin
 meta: Example code for understanding how to use the SessionMixin class from the flask.sessions module of the Flask project.
 
 
-SessionMixin is a class within the flask.sessions module of the Flask project.
+[SessionMixin](https://github.com/pallets/flask/blob/master/src/flask/sessions.py)
+is a class used with [Flask](/flask.html) projects that is defined in
+the `flask.sessions` module. `SessionMixin` expands a standard
+[Python dictionary](https://docs.python.org/3/tutorial/datastructures.html#dictionaries)
+with [session](https://flask.palletsprojects.com/en/1.1.x/quickstart/#sessions)
+attributes.
 
 
 ## Example 1 from Flask-SocketIO
