This is an automated email from the ASF dual-hosted git repository.
mbo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/db-jdo-site.git
The following commit(s) were added to refs/heads/master by this push:
new 8060ce8 JDO-779: Update docs getting-started
8060ce8 is described below
commit 8060ce873ab363fd3f9280b8fc5b358de25a30c6
Author: Michael Bouschen <michael.bousc...@akquinet.de>
AuthorDate: Wed Jul 1 21:44:23 2020 +0200
JDO-779: Update docs getting-started
---
docs/getting-started.html | 48 ++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 47 insertions(+), 1 deletion(-)
diff --git a/docs/getting-started.html b/docs/getting-started.html
index fad0f3b..c1ba811 100644
--- a/docs/getting-started.html
+++ b/docs/getting-started.html
@@ -304,7 +304,53 @@ table.CodeRay td.code>pre{padding:0}
<div class="sect1">
<h2 id="index">Getting Started<a id="Getting_Started"></a></h2>
<div class="sectionbody">
-
+<div class="paragraph">
+<p>Using JDO requires several components that work together:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a database that stores your data persistently</p>
+</li>
+<li>
+<p>an application that operates through the JDO layers on the database</p>
+</li>
+<li>
+<p>a JDO implementation that provides the implementation of the JDO APIs</p>
+</li>
+<li>
+<p>Java classes (object model) that provide the application view of the
data</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>A good place to start is to define your object model. This is the collection
+of Java classes that you use to represent the persistent data in your
+database. Some JDO implementations allow you to create your database schema
+from your object model. Or you might already have a database and database
+schema that you can use to derive the object model.</p>
+</div>
+<div class="paragraph">
+<p>You will also need to define Java classes that implement the application
+that operates on the object model. The application is responsible for
+using the JDO implementation classes to define the application view of
+PersistenceManagerFactory and PersistenceManager.</p>
+</div>
+<div class="paragraph">
+<p>Next, choose a JDO implementation. You can get information
+on JDO implementations <a href="impls.html">here</a>. Some factors to consider
when choosing
+a JDO implementation is what databases they support, what Java version
+they support, and whether they provide tools to create database schema from
+an object model or create an object model from the database schema.</p>
+</div>
+<div class="paragraph">
+<p>Some JDO implementations also package the JDO interfaces as a separate
+jar file, so there may be no need to download the JDO interfaces from this
+site.</p>
+</div>
+<div class="paragraph">
+<p>More information on how to proceed can be found on your JDO implementation
site.</p>
+</div>
</div>
</div>
</div>
