using note directive

zopefoundation · Feb 22, 2009 · 7a33c24 · 7a33c24
1 parent 9511989
commit 7a33c24
Show file tree

Hide file tree

Showing 2 changed files with 27 additions and 26 deletions.
diff --git a/zope2book/source/DTML.rst b/zope2book/source/DTML.rst
@@ -1,19 +1,19 @@
 Basic DTML
 ==========
 
-Preliminary remark (for the Zope 2.12 edition)
-----------------------------------------------
-DTML has been the primary markup language within Zope for a long time.  However
-the *recommended* primary markup language within Zope is nowadays ZPT (Zope
-Page Templates). ZPT is your choice for generating markupish output like HTML
-or XML. The usage of DTML should be limited where you have to generate
-non-markupish output like text files or other formats. Since DTML is pretty old
-it really does not support features like internationalization or unicode very
-well.  In addition the syntax of DTML is not always very easy to understand.
-You have to learn DTML to some point if you intend to use ZSQL methods (for
-RDBMS integration with Zope) - but even for the RDBMS integration we have
-better solutions like Object-Relational-Mappers (check with the chapter about
-relational database connectivity).
+
+.. note::
+    DTML has been the primary markup language within Zope for a long time.  However
+    the *recommended* primary markup language within Zope is nowadays ZPT (Zope
+    Page Templates). ZPT is your choice for generating markupish output like HTML
+    or XML. The usage of DTML should be limited where you have to generate
+    non-markupish output like text files or other formats. Since DTML is pretty old
+    it really does not support features like internationalization or unicode very
+    well.  In addition the syntax of DTML is not always very easy to understand.
+    You have to learn DTML to some point if you intend to use ZSQL methods (for
+    RDBMS integration with Zope) - but even for the RDBMS integration we have
+    better solutions like Object-Relational-Mappers (check with the chapter about
+    relational database connectivity).
 
 Introduction
 ------------

diff --git a/zope2book/source/RelationalDatabases.rst b/zope2book/source/RelationalDatabases.rst
@@ -1,19 +1,20 @@
 Relational Database Connectivity
 ================================
 
-Preliminary remark (for the Zope 2.12 edition)
-----------------------------------------------
-This chapter explains you how to access a relational databases directly through
-SQL. The alternative and modern way integrating a RDBMS with Zope is using an
-Object-Relational-Mapper (ORM). An ORM abstracts the SQL layer and allows you
-to deal with database tables, rows etc. like standard Python objects.
-
-The most common and most flexible ORM in the
-Python world is `SQLAlchemy <http://www.sqlalchemy.org>`_ . You can not use
-SQLAlchemy directly within Zope because the transaction system of the RDBMS
-must participate with Zope transaction. This integration layer is implemented
-through the `zope.sqlalchemy <http://pypi.python.org/pypi/zope.sqlalchemy>`_
-module.
+
+.. note::
+
+    This chapter explains you how to access a relational databases directly through
+    SQL. The alternative and modern way integrating a RDBMS with Zope is using an
+    Object-Relational-Mapper (ORM). An ORM abstracts the SQL layer and allows you
+    to deal with database tables, rows etc. like standard Python objects.
+
+    The most common and most flexible ORM in the
+    Python world is `SQLAlchemy <http://www.sqlalchemy.org>`_ . You can not use
+    SQLAlchemy directly within Zope because the transaction system of the RDBMS
+    must participate with Zope transaction. This integration layer is implemented
+    through the `zope.sqlalchemy <http://pypi.python.org/pypi/zope.sqlalchemy>`_
+    module.
 
 Introduction
 ------------