Browse Source

Update index.rst

-clarified some confusing pronouns.
-improved some coherence
-made some sentences concise
pull/2859/head^2
y2kbcm1 6 years ago committed by GitHub
parent
commit
61f4644d84
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 20
      docs/tutorial/index.rst

20
docs/tutorial/index.rst

@ -20,7 +20,7 @@ Tutorial
next next
This tutorial will walk you through creating a basic blog application 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 and edit or delete their own posts. You will be able to package and
install the application on other computers. install the application on other computers.
@ -29,14 +29,14 @@ install the application on other computers.
:class: screenshot :class: screenshot
:alt: screenshot of index page :alt: screenshot of index page
It's assumed that you're already familiar with Python. The `official You must be familiar with Python first. Refer to the `official
tutorial`_ in the Python docs is a great way to learn or review first. tutorial`_ in the Python docs if needed.
.. _official tutorial: https://docs.python.org/3/tutorial/ .. _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 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 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 project, you might decide to use :ref:`extensions` or other libraries to
make some tasks simpler. make some tasks simpler.
@ -47,11 +47,11 @@ make some tasks simpler.
:alt: screenshot of login page :alt: screenshot of login page
Flask is flexible. It doesn't require you to use any particular project 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 or code layout. However, when first starting, it's helpful to use a structured approach.
structured approach. This means that the tutorial will require a bit of This means that the tutorial will require a bit of
boilerplate up front, but it's done to avoid many common pitfalls that boilerplate up front, but this boilerplate is done to avoid common pitfalls that
new developers encounter, and it creates a project that's easy to expand new developers encounter. This tutorial creates a project that's easy to expand.
on. Once you become more comfortable with Flask, you can step out of Once you become more comfortable with Flask, you can step out of
this structure and take full advantage of Flask's flexibility. this structure and take full advantage of Flask's flexibility.
.. image:: flaskr_edit.png .. image:: flaskr_edit.png

Loading…
Cancel
Save