diff options
| author | Chris McDonough <chrism@agendaless.com> | 2009-11-21 21:52:28 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2009-11-21 21:52:28 +0000 |
| commit | e718d978620eb4123dc2054f5e82de5a7e762cec (patch) | |
| tree | 40a604e787da551189ab1338cdc1cc5e05321836 /docs | |
| parent | 41e3bf143aa55f806d271ed5906a1a5406bb718e (diff) | |
| download | pyramid-e718d978620eb4123dc2054f5e82de5a7e762cec.tar.gz pyramid-e718d978620eb4123dc2054f5e82de5a7e762cec.tar.bz2 pyramid-e718d978620eb4123dc2054f5e82de5a7e762cec.zip | |
Use a sidebar.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/narr/configuration.rst | 27 |
1 files changed, 15 insertions, 12 deletions
diff --git a/docs/narr/configuration.rst b/docs/narr/configuration.rst index a614ee8f8..aaa3e4ae4 100644 --- a/docs/narr/configuration.rst +++ b/docs/narr/configuration.rst @@ -16,18 +16,21 @@ applications. As a framework, the primary job of :mod:`repoze.bfg` is to make it easier for a developer to create an arbitrary web application. -A framework differs from a *library*: library code is always *called* -by code that you write, while a framework always *calls* code that you -write. Using the average library is typically easier than using the -average framework. During typical library usage, the developer can -more granularly avoid ceding any control to code he does not himself -author. During typical framework usage, however, the developer must -cede a greater portion of control to the framework. In practice, -using a framework to create a web application is often more practical -than using a set of libraries if the framework provides a set of -facilities and assumptions that fit a large portion of your -application requirements. :mod:`repoze.bfg` is a framework that fits -a large set of assumptions in the domain of web application creation. +.. sidebar:: Frameworks vs. Libraries + + A framework differs from a *library*: library code is always + *called* by code that you write, while a framework always *calls* + code that you write. Using the average library is typically easier + than using the average framework. During typical library usage, + the developer can more granularly avoid ceding any control to code + he does not himself author. During typical framework usage, + however, the developer must cede a greater portion of control to + the framework. In practice, using a framework to create a web + application is often more practical than using a set of libraries + if the framework provides a set of facilities and assumptions that + fit a large portion of your application requirements. + :mod:`repoze.bfg` is a framework that fits a large set of + assumptions in the domain of web application creation. Because :mod:`repoze.bfg` is a framework, from the perspective of the people who have written :mod:`repoze.bfg` itself, each deployment of |