summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorcewing <cris@crisewing.com>2016-06-03 17:00:59 -0700
committercewing <cris@crisewing.com>2016-06-09 11:20:55 -0700
commit0c4065080b6078c9d7495e28402718591f8e294b (patch)
tree7b435351d97ec3c38b518bf9d53912c750057997 /docs
parent8c12559d800cde22d28a3cbc2ad5897c49768cb3 (diff)
downloadpyramid-0c4065080b6078c9d7495e28402718591f8e294b.tar.gz
pyramid-0c4065080b6078c9d7495e28402718591f8e294b.tar.bz2
pyramid-0c4065080b6078c9d7495e28402718591f8e294b.zip
update the dynamic development section
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/introduction.rst26
1 files changed, 12 insertions, 14 deletions
diff --git a/docs/narr/introduction.rst b/docs/narr/introduction.rst
index 6a27cb715..471b7a2ec 100644
--- a/docs/narr/introduction.rst
+++ b/docs/narr/introduction.rst
@@ -142,21 +142,19 @@ code.
Example: :ref:`static_assets_section`.
-Fully interactive development
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Develop interactively
+~~~~~~~~~~~~~~~~~~~~~
+
+Pyramid can automatically detect changes you make to template files and code,
+so your changes are immediately available in your browser. You can debug using
+plain old ``print()`` calls, which will display to your console.
+
+Pyramid has a debug toolbar that allows you to see information about how your
+application is working right in your browser. See configuration, installed
+packages, SQL queries, logging statements and more.
-When developing a Pyramid application, several interactive features are
-available. Pyramid can automatically utilize changed templates when rendering
-pages and automatically restart the application to incorporate changed Python
-code. Plain old ``print()`` calls used for debugging can display to a console.
-
-Pyramid's debug toolbar comes activated when you use a Pyramid scaffold to
-render a project. This toolbar overlays your application in the browser, and
-allows you access to framework data, such as the routes configured, the last
-renderings performed, the current set of packages installed, SQLAlchemy queries
-run, logging data, and various other facts. When an exception occurs, you can
-use its interactive debugger to poke around right in your browser to try to
-determine the cause of the exception. It's handy.
+When your application has an error, an interactive debugger allows you to poke
+around from your browser to find out what happened.
Example: :ref:`debug_toolbar`.