* Clean up tutorial docs for installable app pattern
- reading sequentially through the tutorial works.
- fixes references to `export FLASK_APP=flaskr.flaskr`
* Fixes titles for each section of flaskr tutorial
* Revert grammar
* Emphasize the Packaging Guide
- adds more general packaging resource
- removes the emphasis put on setuptools
* rephrase and remove note admonitions
- expanded on few points
- removed note blocks, they are unneccessary
* Remove note about reinstalling to update cli
- I had mistakenly thought it was necessary to
re-install the app to update the cli.
- the `--editable` flag detects the change and
the cli updates without issue.
* Converts example/flaskr to have a setup.py
Makes the flaskr app easier to run, ex. workflow:
- pip install --editable .
- export FLASK_APP=flaskr.flaskr
- flask initdb
- flask run
Testing is also easier now:
- python setup.py test
* Fixed an import error in flaskr/tests
- the statement `import flaskr` caused errors in python3
- `from . import flaskr` fixes the issue in 2.7.11 and 3.5.1
* Better project structure and updates the docs
- Re-factors *flaskr*'s project structure a bit
- Updates docs to make sense with the new structure
- Adds a new step about installing Flask apps with setuptools
- Switches first-person style writing to second-person (reads better IMO)
- Adds segments in *testing.rst* for running tests with setuptools
* Remove __init__.py from tests
- py.test recommends not using __init__.py
* Fix testing import errors
* Clarify instructions about changing row_factory
When I was working through the tutorial, this was very confusing to me; so, I've added the code and clarification that would have helped me get through it faster.
* Clarify the nature of Row objects
* Rewrite code example for further clarity.
* Mention the template name conflict issue in docs.
In the blueprints templates documentation mention
the possible templates name conflict issue
re #266
* Mention priorities between blueprints
and other rephrasing fixes
Reason: Messages of size 68,493 - 91,326 characters cause flash to fail silently.
Session cookies cannot have such large messages.
Issue: pallets/flask#1789
As per their email ‘Changes to project subdomains’:
> Starting today, Read the Docs will start hosting projects from subdomains on the domain readthedocs.io, instead of on readthedocs.org. This change addresses some security concerns around site cookies while hosting user generated data on the same domain as our dashboard.
Test Plan: Manually visited all the links I’ve modified.