notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

svn commit: r1402 - in development/main/central/site/src/docs: . concepts concepts/patterns products products/transit

From: dleangen AT netcompartner.com
To: notify-dpml AT lists.ibiblio.org
Subject: svn commit: r1402 - in development/main/central/site/src/docs: . concepts concepts/patterns products products/transit
Date: Fri, 07 Jan 2005 12:26:20 +0100

Author: dleangen
Date: Fri Jan 7 12:26:20 2005
New Revision: 1402

Added:
development/main/central/site/src/docs/concepts/
development/main/central/site/src/docs/concepts/index.xml
development/main/central/site/src/docs/concepts/navigation.xml
development/main/central/site/src/docs/concepts/patterns/
development/main/central/site/src/docs/concepts/patterns/index.xml
development/main/central/site/src/docs/concepts/patterns/interface_impl.xml
development/main/central/site/src/docs/concepts/patterns/navigation.xml

development/main/central/site/src/docs/concepts/repository_enabled_application.xml
Modified:
development/main/central/site/src/docs/navigation.xml
development/main/central/site/src/docs/products/index.xml
development/main/central/site/src/docs/products/transit/index.xml
Log:
Simplified docs.

Added: development/main/central/site/src/docs/concepts/index.xml
==============================================================================
--- (empty file)
+++ development/main/central/site/src/docs/concepts/index.xml Fri Jan 7
12:26:20 2005
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="DPML Concepts">
+
+ <p role="intro">
+ Understanding the DPML community requires the knowledge of a few
basic concepts.
+ </p>
+
+ <p>
+ <table>
+ <tr>
+ <th>Concept</th>
+ <th>Meaning</th>
+ </tr>
+ <tr>
+ <td><a name="artifact" href=""><strong>artifact</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="artifact_url" href=""><strong>artifact
URL</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="cache_management_layer" href=""><strong>cache
management layer</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="enabled_solution" href=""><strong>enabled
solution</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="interface_impl_pattern"
href=""><strong>interface/impl pattern</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="local_cache" href=""><strong>local
cache</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="local_cache_manager" href=""><strong>local cache
manager</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="logical_identifier" href=""><strong>logical
identifier</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ <tr>
+ <td><a name="repository_enabled_application"
href="repository_enabled_application.html"><strong>repository
+ enabled application</strong></a></td>
+ <td>
+ An application that leverages a
+ <a href="#local_cache">local cache</a> of <a
href="#artifact">artifacts</a>.
+ </td>
+ </tr>
+ <tr>
+ <td><a name="remote_repository"
href=""><strong>remote_repository</strong></a></td>
+ <td>
+ </td>
+ </tr>
+ </table>
+ </p>
+
+ </section>
+ </body>
+</document>
+

Added: development/main/central/site/src/docs/concepts/navigation.xml
==============================================================================
--- (empty file)
+++ development/main/central/site/src/docs/concepts/navigation.xml Fri
Jan 7 12:26:20 2005
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+
+
+<project>
+
+ <title>DPML Concepts</title>
+
+ <body>
+
+ <menu>
+ <item name="Concepts" href="index.html"/>
+ 
+ <item name="Patterns" href="patterns/index.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added: development/main/central/site/src/docs/concepts/patterns/index.xml
==============================================================================
--- (empty file)
+++ development/main/central/site/src/docs/concepts/patterns/index.xml Fri
Jan 7 12:26:20 2005
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document verified="false">
+ <properties>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Core Design Patterns">
+
+ <p role="intro">
+ DPML solutions are built around a few core design patterns.
+
+ <ul>
+ <li><a href="interface_impl.html">interface/impl</a></li>
+ </ul>
+
+ </p>
+
+ </section>
+ </body>
+</document>
+

Added:
development/main/central/site/src/docs/concepts/patterns/interface_impl.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/concepts/patterns/interface_impl.xml
Fri Jan 7 12:26:20 2005
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document verified="false">
+ <properties>
+ <author email="dleangen AT dpml.net">David Leangen</author>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Interface/Impl Pattern">
+
+ <p role="intro">
+ </p>
+
+ <p>
+ </p>
+
+ </section>
+ </body>
+</document>
+

Added: development/main/central/site/src/docs/concepts/patterns/navigation.xml
==============================================================================
--- (empty file)
+++ development/main/central/site/src/docs/concepts/patterns/navigation.xml
Fri Jan 7 12:26:20 2005
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+
+
+<project>
+
+ <title>DPML Concepts</title>
+
+ <body>
+
+ <menu>
+ <item name="Interface/Impl" href="interface_impl.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/concepts/repository_enabled_application.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/concepts/repository_enabled_application.xml
Fri Jan 7 12:26:20 2005
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Repository Enabled Application">
+
+ <p role="intro">
+ A repository enabled application is an application the leverages a
local
+ cache of artifacts.
+ </p>
+
+ <p>
+ Each <a href="index.html#artifact">artifact</a> in the
+ <a href="index.html#local_cache">local cache</a> is referenced by
+ <a href="index.html#logical_identifier">logical identifiers</a>.
+ Identifiers typically reference content in the form of an
+ <a href="index.html#artifact_url">artifact URL</a>, such as
+ artifact:block:dpml/planet/http/dpml-http-server#SNAPSHOT.
+ </p>
+
+ <p>
+ These identifiers disassociate the definition of an application from
+ the source of the resources needed to build and deploy the
application.
+ This is important in order to strictly adhere to the
+ <a href="index.html#interface_impl_pattern">interface/impl
pattern</a>.
+ </p>
+ </section>
+ </body>
+</document>

Modified: development/main/central/site/src/docs/navigation.xml
==============================================================================
--- development/main/central/site/src/docs/navigation.xml (original)
+++ development/main/central/site/src/docs/navigation.xml Fri Jan 7
12:26:20 2005
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>


+ <item name="Concepts" href="concepts/index.html"/>
<item name="Resources" href="about/resources/index.html"/>
<item name="Community" href="about/community/index.html"/>
<item name="News and Events" href="about/news/index.html"/>

Modified: development/main/central/site/src/docs/products/index.xml
==============================================================================
--- development/main/central/site/src/docs/products/index.xml (original)
+++ development/main/central/site/src/docs/products/index.xml Fri Jan 7
12:26:20 2005
@@ -1,28 +1,25 @@
<?xml version="1.0" encoding="ISO-8859-1"?>

-<document>
+<document verified="false">
<properties>
<author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
<title>DPML Products</title>
</properties>

<body>
<section name="DPML Products">

- <p>
- The DPML provides a number of products dealing with different
aspects of
- advanced component-oriented development.
- </p>
-
<table>
<tr>
<th>Product</th>
<th>Function</th>
</tr>
<tr>
- <td><a href="metro/index.html">Metro</a></td>
+ <td><a href="metro/index.html"><strong>Metro</strong></a></td>
<td>
- The Metro system is a container that provides comprehensive
support for
+ The Metro system is a <strong>light weight container</strong>
+ that provides comprehensive support for
the management of complex component based systems based on an
underlying
meta-model that facilitates automated assembly and deployment
of components.
Metro aims to simplify the process of managing component-based
systems. It
@@ -35,21 +32,25 @@
</td>
</tr>
<tr>
- <td><a href="magic/index.html">Magic</a></td>
+ <td><a href="magic/index.html"><strong>Magic</strong></a></td>
<td>
- Magic is an advanced build system for Java based component
development.
+ Magic is an <strong>advanced build system</strong> for Java
based component
+ development.
It provides support for a centralized project object model,
version and
dependency management, and a suite of tools that automate the
processes
of building well-structured component solutions.
</td>
</tr>
<tr>
- <td><a href="transit/index.html">Transit</a></td>
+ <td><a
href="transit/index.html"><strong>Transit</strong></a></td>
<td>
- Transit is a protocol handler that provides support for the
the
- cache management layer of a repository enabled application.
The notion
- enabled solutions is central theme present in all DPML
solutions - form
- the Magic build platform thorugh to the Metro containment
system.
+ Transit is a <strong>protocol handler</strong> that provides
support for the
+ <a href="../concepts/index.html#cache_management_layer">cache
management layer</a>
+ of a
+ <a
href="../concepts/index.html#repository_enabled_application">repository
enabled application</a>.
+ The notion of
+ "<a href="../concepts/index.html#enabled_solution">enabled
solutions</a>"
+ is central theme present in all DPML solutions.
</td>
</tr>
</table>

Modified: development/main/central/site/src/docs/products/transit/index.xml
==============================================================================
--- development/main/central/site/src/docs/products/transit/index.xml
(original)
+++ development/main/central/site/src/docs/products/transit/index.xml Fri
Jan 7 12:26:20 2005
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?>



-<document>
+<document verified="false">
<properties>
<author email="mcconnell AT dpml.net">Stephen McConnell</author>
<author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
<title>DPML Transit</title>
</properties>

<body>
- <section name="Repository Enabled Solution">
+ <section name="Transit Protocol Handler">

+ <p role="intro">
+ Transit is a <strong>protocol handler</strong> that provides support
for the
+ <a href="../../concepts/index.html#cache_management_layer">cache
management layer</a>
+ of a
+ <a
href="../../concepts/repository_enabled_application.html">repository enabled
application</a>.
+ </p>
<p>
-A repository enabled application is an application the leverages a local
-cache of artifacts that are referenced by logical identifiers. Identifiers
-typically reference content in the form of an artifact url such as
-artifact:block:dpml/planet/http/dpml-http-server#SNAPSHOT. These
-identifiers disassociate the definition of an application from the source
-of the resources needed to build and deploy the application.
+ A DPML-enabled application will normally make content requests to a
+ <a href="../../concepts/index.html#local_cache_manager">local cache
manager</a>.
+ The cache manager interacts with one or more
+ <a href="../../concepts/index.html#remote_repository">remote
repositories</a> to resolve
+ application requests.
</p>
+
<p>
-An application will normally make content requests to a local cache manager
-which in turn interacts with one or more remote repositories to resolve
-application requests. Varying levels of quality of service are provided by
-repository systems, for example, a local cache manager can provide a level
-of control over which repositories are accesses and provide content
-validation. In addition, intelligent remote repositories can provide advanced
-solutions including automated generation of artifacts relative to cache
-manager requests, content filtering, referral management, and solutions
-customized relative to client identity.
+ Applications will make such requests when they require resources,
such as
+ JAR files, in order to operate correctly.
</p>
+
<p>
-More information about <a href="/guide/setup/index.html">installation</a>
and
-the use of Transit in resource and plugin management (including examples) is
-available in the <a href="/guide/transit/index.html">Transit Guide</a>.
-Specifications of Transit <a href="properties/index.html">properties</a>,
the Transit
-<a href="protocol/index.html">artifact protocol</a> and the Transit
-<a href="launcher/index.html">application launcher</a> are available here.
+ In most cases, other than understanding the
+ <a href="protocol/index.html">artifact protocol</a>, you will not
need to interact
+ directly with Transit. Other DPML solutions, such as
+ <a href="../magic/index.html">Magic</a> and
+ <a href="../metro/index.html">Metro</a>,
+ will use Transit transparently to the user.
</p>

+ 
+
<img src="../../images/transit/repositories.png"/>
+
+ <p>
+ More information:
+ <ul>
+ <li><a href="/guide/setup/index.html">installation</a></li>
+ <li><a href="/guide/transit/index.html">Transit Guide</a></li>
+ <li><a href="properties/index.html">properties
specifications</a></li>
+ <li><a href="protocol/index.html">artifact protocol</a></li>
+ <li><a href="launcher/index.html">application launcher</a></li>
+ </ul>
+ </p>
+
</section>
</body>
</document>
-

svn commit: r1402 - in development/main/central/site/src/docs: . concepts concepts/patterns products products/transit, dleangen, 01/07/2005