diff --git a/docs/tutorial/index.rst b/docs/tutorial/index.rst index 9b43c510..95b2e5f8 100644 --- a/docs/tutorial/index.rst +++ b/docs/tutorial/index.rst @@ -20,7 +20,7 @@ Tutorial next This tutorial will walk you through creating a basic blog application -called Flaskr. Users will be able to register, log in, create posts, +called Flaskr, where users will be able to register, log in, create posts, and edit or delete their own posts. You will be able to package and install the application on other computers. @@ -29,14 +29,14 @@ install the application on other computers. :class: screenshot :alt: screenshot of index page -It's assumed that you're already familiar with Python. The `official -tutorial`_ in the Python docs is a great way to learn or review first. +You must be familiar with Python first. Refer to the `official +tutorial`_ in the Python docs if needed. .. _official tutorial: https://docs.python.org/3/tutorial/ -While it's designed to give a good starting point, the tutorial doesn't +Even though this tutorial is designed to give a good starting point, it doesn't cover all of Flask's features. Check out the :ref:`quickstart` for an -overview of what Flask can do, then dive into the docs to find out more. +overview of what Flask can do, and then dive into the docs to find out more. The tutorial only uses what's provided by Flask and Python. In another project, you might decide to use :ref:`extensions` or other libraries to make some tasks simpler. @@ -47,11 +47,11 @@ make some tasks simpler. :alt: screenshot of login page Flask is flexible. It doesn't require you to use any particular project -or code layout. However, when first starting, it's helpful to use a more -structured approach. This means that the tutorial will require a bit of -boilerplate up front, but it's done to avoid many common pitfalls that -new developers encounter, and it creates a project that's easy to expand -on. Once you become more comfortable with Flask, you can step out of +or code layout. However, when first starting, it's helpful to use a structured approach. +This means that the tutorial will require a bit of +boilerplate up front, but this boilerplate is done to avoid common pitfalls that +new developers encounter. This tutorial creates a project that's easy to expand. +Once you become more comfortable with Flask, you can step out of this structure and take full advantage of Flask's flexibility. .. image:: flaskr_edit.png