From e6855bbd24a006e729bacc343660e3001cae3919 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Thu, 2 Jul 2009 10:06:34 +0000 Subject: - Added an "Extending" chapter to the narrative documentation which explains how to extend or modify an existing BFG application using another Python package and ZCML. --- docs/narr/introduction.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'docs/narr/introduction.rst') diff --git a/docs/narr/introduction.rst b/docs/narr/introduction.rst index f8d066d06..53f3763a2 100644 --- a/docs/narr/introduction.rst +++ b/docs/narr/introduction.rst @@ -18,7 +18,9 @@ Architecture ("CA") internally, as do Zope 2, Zope 3, and :term:`Grok`. Application :mod:`repoze.bfg` developers use either :term:`ZCML` (an XML dialect, used in Zope) or decorators to perform various configuration tasks. The decorator support is provided by the -:term:`Grok` project. +:term:`Grok` project. Like Zope, :mod:`repoze.bfg` allows you to +create applications which do not need to be forked to be extended by a +third party developer. Like :term:`Pylons`, :mod:`repoze.bfg` is mostly policy-free. It makes no assertions about which database you should use, and its @@ -89,6 +91,14 @@ framework itself rather than by user code. Such a task would typically be performed by user-space decorators in other Python web frameworks. +Like Zope, but unlike :term:`Pylons` or :term:`Django`, when you build +a :mod:`repoze.bfg` application, if you obey certain constraints, the +application you produce can be reused, modified, re-integrated, or +extended by third-party developers without modification to the +original application itself. See :ref:`extending_chapter` for more +information about extending or modifying an existing :mod:`repoze.bfg` +application. + Unlike application development using Zope, application developers don't interact with the Zope Component Architecture ("CA") very much during :mod:`repoze.bfg` application development. Instead, the -- cgit v1.2.3