From e718d978620eb4123dc2054f5e82de5a7e762cec Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Sat, 21 Nov 2009 21:52:28 +0000 Subject: Use a sidebar. --- docs/narr/configuration.rst | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) (limited to 'docs') 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 -- cgit v1.2.3