Skip to content

Commit 41f936a

Browse files
push rewording on pyramid
restore recommendations on django and flask
1 parent 05531d6 commit 41f936a

File tree

1 file changed

+19
-5
lines changed

1 file changed

+19
-5
lines changed

docs/scenarios/web.rst

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,9 @@ project as-is, or customized to fit your needs.
6161
There are annual Django conferences `in the United States
6262
<http://djangocon.us>`_ and `in Europe <http://djangocon.eu>`_.
6363

64+
Django is a popular framework and you will find many sites and projects built
65+
with on it.
66+
6467
Flask
6568
-----
6669

@@ -83,6 +86,8 @@ For those that do, there are many
8386
`Extensions <http://flask.pocoo.org/extensions/>`_ available that may
8487
suit your needs. Or, you can easily use any library you want yourself!
8588

89+
Flask is a common choice over Django because it is for developers who like
90+
minimalistic approach.
8691

8792
Tornado
8893
--------
@@ -98,17 +103,26 @@ Pyramid
98103
--------
99104

100105
`Pyramid <http://www.pylonsproject.org/>`_ lies somewhere between a big
101-
framework like Django and the microframeworks: It comes with a lot of libraries
102-
and functionality and can thus not be considered lightweight. On the other
103-
hand, it does not provide all the functionality Django does. Instead Pyramid
104-
brings basic support for most regular tasks and provides a great deal of
105-
extensibility. Additionally, Pyramid has a huge focus on complete
106+
framework like Django and the microframeworks. Instead, it practices a modular
107+
approach where you can specify include any libraries as needed which provides a
108+
great deal of extensibility. By contrast to Django which includes everything in
109+
one package (though you might not need to use it all).
110+
111+
Notably, Pyramid provides a lot of adapter to existing libraries. For example,
112+
it supports nearly all the templating languages Python has to offer and
113+
it's modular approach allows you use more then one. Same is true of it's
114+
database support. You can use SQLAlchemy, Mongo, ZoDB all in the same
115+
application without much trouble.
116+
117+
Additionally, Pyramid has a huge focus on complete
106118
`documentation <http://docs.pylonsproject.org/en/latest/docs/pyramid.html>`__
107119
and boast 100% unittest coverage.
108120

109121
**Support** can also be found in the
110122
`documentation <http://docs.pylonsproject.org/en/latest/index.html#support-desc>`__.
111123

124+
Pyramid is a good choice for developers who like flexibility of their
125+
application including what they need and nothing extra.
112126

113127
Web Servers
114128
:::::::::::

0 commit comments

Comments
 (0)