add simple NH Quickstart docs

doc/reference/src/nh-quickstart.xml

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+/*
+ * Copyright 2002-2008 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+-->
+<chapter version="5" xml:id="nh-quickstart"
+         xmlns="http://docbook.org/ns/docbook"
+         xmlns:ns5="http://www.w3.org/2000/svg"
+         xmlns:ns4="http://www.w3.org/1999/xhtml"
+         xmlns:ns3="http://www.w3.org/1998/Math/MathML"
+         xmlns:ns2="http://www.w3.org/1999/xlink"
+         xmlns:ns="http://docbook.org/ns/docbook">
+  <title>NHibernate QuickStart</title>
+
+  <section>
+    <title>Introduction</title>
+
+    <para>This QuickStart application uses the all too familiar Northwind
+    database and uses NHibernate browse and edit customers. It It is a very
+    simple application that directly uses the DAO layer in some cases and also
+    has a simple service layer that simulated a fullillment process. See the
+    integration tests as well for insight into how it works. The application
+    uses Spring's declarative transaction management features,
+    HibernateTemplate helper class, and Open Session In View module. <note>The
+    example will be updated to not use HibernateTemplate and instead use the
+    standard NHibernate API in a future release. All functionality is still
+    present when using the standard NHibernate API, as Spring transaction
+    managment is integrated into NHibernate extension points and exception
+    translation is provided by AOP advice. See the section titled Implementing
+    DAOs based on plain Hibernate 1.2/2.0 API" in the hibernate orm section of
+    the reference docs for more information.</note>To run the application
+    make the Web application
+    the project that starts and set Default.aspx as the start page. You will
+    see a list of customers. If you select 'edit' then you can edit some
+    customer info and save it by pressing the save button. Note that you will
+    need to explicitly navigate back to the Default.aspx page and reload it in
+    order to see the changes.</para>
+  </section>
+</chapter>