update flask examples descriptions

mattmakai · mattmakai · commit 93f09a59020e · 2020-07-10T11:10:18.000-04:00
diff --git a/content/pages/examples/flask/flask-templating-render-template-string.markdown b/content/pages/examples/flask/flask-templating-render-template-string.markdown
@@ -7,7 +7,20 @@ sidebartitle: flask.templating render_template_string
 meta: Python example code that shows how to use the render_template_string callable from the flask.templating module of the Flask project.
 
 
-render_template_string is a callable within the flask.templating module of the Flask project.
+[render_template_string](https://github.com/pallets/flask/blob/master/src/flask/templating.py)
+is a [Flask](/flask.html) function from the `flask.templating` package.
+`render_template` is used to generate output from a string
+that is passed in rather than from a file in the templates folder.
+
+Note that `render_template_string` is sometimes imported from the `flask`
+package instead of from `flask.templating`. It is the same function that is
+imported, but there are less characters to type when you leave off
+the `.templating` part.
+Understanding the following concepts are useful when coding projects that use `render_template_string`:
+
+
+* [template engines](/template-engines.html), specifically [Jinja2](/jinja2.html)
+* [Flask](/flask.html) and the concepts for [web frameworks](/web-frameworks.html)
 
 
 ## Example 1 from Flask-User
diff --git a/content/pages/examples/flask/flask-templating-render-template.markdown b/content/pages/examples/flask/flask-templating-render-template.markdown
@@ -17,6 +17,11 @@ Note that `render_template` is typically imported directly from the `flask`
 package instead of from `flask.templating`. It is the same function that is
 imported, but there are less characters to type when you leave off
 the `.templating` part.
+Understanding the following concepts are useful when coding projects that use `render_template`:
+
+
+* [template engines](/template-engines.html), specifically [Jinja2](/jinja2.html)
+* [Flask](/flask.html) and the concepts for [web frameworks](/web-frameworks.html)
 
 
 ## Example 1 from Braintree Flask app
diff --git a/content/pages/examples/flask/flask-views-methodview.markdown b/content/pages/examples/flask/flask-views-methodview.markdown
@@ -7,7 +7,12 @@ sidebartitle: flask.views MethodView
 meta: Example code for understanding how to use the MethodView class from the flask.views module of the Flask project.
 
 
-MethodView is a class within the flask.views module of the Flask project.
+[MethodView](https://github.com/pallets/flask/blob/master/src/flask/views.py)
+is a class within the `flask.views` module of the [Flask](/flask.html)
+project. `MethodView` is a
+[Python Metaclass](https://stackoverflow.com/questions/100003/what-are-metaclasses-in-python)
+that determines the methods, such as GET, POST, PUT, etc, that
+a view defines.
 
 
 ## Example 1 from FlaskBB
diff --git a/content/pages/examples/flask/flask-views-view.markdown b/content/pages/examples/flask/flask-views-view.markdown
@@ -7,7 +7,13 @@ sidebartitle: flask.views View
 meta: Example code for understanding how to use the View class from the flask.views module of the Flask project.
 
 
-View is a class within the flask.views module of the Flask project.
+[View](https://github.com/pallets/flask/blob/master/src/flask/views.py)
+is a class within the `flask.views` module of the [Flask](/flask.html)
+project. `View` provides an alternative way to use view functions
+by subclassing this class and implementing `dispatch_request`
+for the routing system. This is typically only used in more advanced
+situations such as extending the Flask source code, rather than
+a standard way of interacting with the framework.
 
 
 ## Example 1 from FlaskBB
