orbit-oss/flask
4
4
Fork 2
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

More doc changes regarding foreword

Browse source
This commit is contained in:
Armin Ronacher 2010-07-05 11:06:29 +02:00
parent 77e2fbf249
commit 56796f0f43
1 changed files with 11 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

21
docs/foreword.rst
View file

@ -10,9 +10,10 @@ What does "micro" mean?
To me, the "micro" in microframework refers not only to the simplicity and To me, the "micro" in microframework refers not only to the simplicity and
small size of the framework, but also to the typically limited complexity small size of the framework, but also to the typically limited complexity
and size of applications that are written with the framework. To be and size of applications that are written with the framework. Also the
approachable and concise, a microframework sacrifices a few features that fact that you can have an entire application in a single Python file. To
may be necessary in larger or more complex applications. be approachable and concise, a microframework sacrifices a few features
that may be necessary in larger or more complex applications.
For example, Flask uses thread-local objects internally so that you don't For example, Flask uses thread-local objects internally so that you don't
have to pass objects around from function to function within a request in have to pass objects around from function to function within a request in
@ -72,13 +73,13 @@ So always keep security in mind when doing web development.
Target Audience Target Audience
--------------- ---------------
Is Flask for you? If your application is small-ish and does not depend on Is Flask for you? If your application is small or medium sized and does
very complex database structures, Flask is the Framework for you. It was not depend on very complex database structures, Flask is the Framework for
designed from the ground up to be easy to use, and built on the firm you. It was designed from the ground up to be easy to use, and built on
foundation of established principles, good intentions, and mature, widely the firm foundation of established principles, good intentions, and
used libraries. Recent versions of Flask scale nicely within reasonable mature, widely used libraries. Recent versions of Flask scale nicely
bounds, and if you grow larger, you won't have any trouble adjusting Flask within reasonable bounds, and if you grow larger, you won't have any
for your new application size. trouble adjusting Flask for your new application size.
If you suddenly discover that your application grows larger than If you suddenly discover that your application grows larger than
originally intended, head over to the :ref:`becomingbig` section to see originally intended, head over to the :ref:`becomingbig` section to see