diff options
| author |   liamfallon <liam.fallon@est.tech> | 2020-07-13 09:41:28 +0100 |
|---|---|---|
| committer | liamfallon <liam.fallon@est.tech> | 2020-07-13 09:55:31 +0100 |
| commit | cfd849936ab0dba02df60c5a8509d83cb8c58fdb (patch) | |
| tree | edbdaaf25ee23994f7bbc9e5d882e3cd08d9bce1 /src/site/xdoc | |
| parent | 3b1c78af2c59867d422a29ea4ff325ba25fea4cc (diff) | |
Remove old documentation from build
apex-pdp had an in-line docuemntation build system built on asciidoc. It
has proven to be very difficult to maintain and keep up to date and it
is incompatible with the ONAP official RST/ReadTheDocs docuementation
system.
In the Dublin release, we converted the asciidoc documentation to RST
format, and hae been updating the RST documentation since. The asciidoc
docuemntation system is now so out of date that it is being removed.
In this change, the "site" directory is removed from all modules in
apex-pdp and a profile called "apexSite" is removed from the pom.xml
file in all modules.
Issue-ID: POLICY-2686
Change-Id: I645f3ed101159d356cd90e619cef791067ad5eb5
Signed-off-by: liamfallon <liam.fallon@est.tech>
Diffstat (limited to 'src/site/xdoc')
| -rw-r--r-- | src/site/xdoc/developer-guide.xml | 93 | ||||
| -rw-r--r-- | src/site/xdoc/index.xml | 320 | ||||
| -rw-r--r-- | src/site/xdoc/policy-guide.xml | 96 | ||||
| -rw-r--r-- | src/site/xdoc/user-manual.xml | 150 |
4 files changed, 0 insertions, 659 deletions
diff --git a/src/site/xdoc/developer-guide.xml b/src/site/xdoc/developer-guide.xml deleted file mode 100644 index 40e689739..000000000 --- a/src/site/xdoc/developer-guide.xml +++ /dev/null @@ -1,93 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - ============LICENSE_START======================================================= - Copyright (C) 2016-2018 Ericsson. All rights reserved. - ================================================================================ - This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE - Full license text at https://creativecommons.org/licenses/by/4.0/legalcode - - SPDX-License-Identifier: CC-BY-4.0 - ============LICENSE_END========================================================= - - @author Sven van der Meer (sven.van.der.meer@ericsson.com) - ---> - -<document> - <properties> - <title>The APEX Developer Guide</title> - <author email="sven.van.der.meer@ericsson.com">Sven van der Meer</author> - <author email="liam.fallon@ericsson.com">Liam Fallon</author> - <author email="john.keeney@ericsson.com">John Keeny</author> - </properties> - <body> - - <section name="The APEX Developer Guide"> - - <p> - The APEX developer guide combines a set of guides and howto documents, all addressing aspects for APEX developers. - These documents look at APEX internals and how to extend build and extend the platform, and how to add applications. - The guide and howto documents are provided as integrated documentation in the APEX site. - Furthermore, we provide stand-alone documents in HTML and PDF. - </p> - - <p> - Note: most of the documentation is written in AsciiDoc. - We are using the AsciiDoctor version. - Due to the different build tools used for the different documentation targets, the rendered documents differ in style. - The content however comes always from a single, normative source located in the APEX source repositories. - </p> - - <h3>APEX User Manual documentation</h3> - <table> - <tr> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="20%">Name</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="50%">Description</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="30%">Links</th> - </tr> - <tr> - <td>Developer Guide</td> - <td> - The complete APEX Developer Guide, including all HowTos and other documentation. - The stand-alone versions aggregate all other documents listed in this table. - </td> - <td> - <ul> - <li><a href="docs-apex/html/APEX-Developer-Guide.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/APEX-Developer-Guide.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: Build APEX from source</td> - <td> - This HowTo details all variations to build APEX from the source code. - Some of the options are: standard build with and without tests, build with all test, build with all components. - The document also shows how to build the documentation and the APEX site. - </td> - <td> - <ul> - <li><a href="developer-guide/build/dg-build.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-Build-APEX.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-Build-APEX.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: Codestyle and Automated Style Checks</td> - <td> - This HowTo defines the Java coding rules when developing for the APEX system and any of its components. - It details how to install and configure required Eclipse plugins (JAutoDoc, Checkstyle) and how to run automated style checks. - </td> - <td> - <ul> - <li><a href="developer-guide/codestyle/dg-codestyle.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-Codestyle.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-Codestyle.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - </table> - </section> - </body> -</document> diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml deleted file mode 100644 index a18539b3c..000000000 --- a/src/site/xdoc/index.xml +++ /dev/null @@ -1,320 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - ============LICENSE_START======================================================= - Copyright (C) 2016-2018 Ericsson. All rights reserved. - ================================================================================ - This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE - Full license text at https://creativecommons.org/licenses/by/4.0/legalcode - - SPDX-License-Identifier: CC-BY-4.0 - ============LICENSE_END========================================================= - - @author Sven van der Meer (sven.van.der.meer@ericsson.com) - ---> - -<document> - - <properties> - <title>Welcome to APEX - The Adaptive Policy EXecution (Engine)</title> - <author email="sven.van.der.meer@ericsson.com">Sven van der Meer</author> - <author email="liam.fallon@ericsson.com">Liam Fallon</author> - <author email="john.keeney@ericsson.com">John Keeny</author> - </properties> - - <body> - <section name="Welcome to APEX - The Adaptive Policy EXecution (Engine)"> - - <p> - The APEX (Adaptive Policy Execution) policy engine is a fully featured policy engine that executes anything from simple to adaptive policies. - An adaptive policy is one that can modify its behavior based on the current conditions of the network and systems. - Adaptive policies have the following characteristics: - <ul> - <li>Are able to make decisions at runtime rather than simply selecting decisions described at policy definition time</li> - <li>Can use additional context information that was not provided in the incoming event or request</li> - <li>Can be adapted or self-adapt at runtime to modify decision making</li> - </ul> - </p> - - <p> - The APEX policy engine accepts input events and requests from other components, routes the input to the appropriate policies, computes the policy results, and generates response events or actions to be processed by other components. - The policies may be affected by information injected into the policy context as changes in business or domain goals, by information derived from previous executions of the policies, and by context information retrieved from other components (analytics, inventory, topology, etc.). - </p> - - <p> - APEX connects to a Trigger System to receive events that can trigger a policy and to an Actioning System to send the result of a policy. - The connection support various common technologies, such as messaging systems (Kafka, Websockets), file input/output, and standard input/output. - APEX supports context (as additional information) for all events as well as inside the engine to support policies. - Context information can be read from any outside source. - </p> - - <p> - A policy is defined in a Universal Execution Policy Specification (UEPS), directly executable in an APEX engine. - Higher-level policy specifications (or existing policy languages) can be easily translated in UEPS. - </p> - - <p> - An APEX system can use multiple policy engines with different policies deployed on each of them. - Context information is automatically shared between all engine instances. - A simple deployment component is provided. - </p> - - - <h3>APEX Documentation</h3> - <table> - <tr> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Document</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Description</th> - </tr> - <tr> - <td><a href="apex-intro/intro-introduction.html">APEX Introduction</a></td> - <td> - This is a short introduction to APEX to show its features and capabilities. - - <br /><br /> - Also available as - <a href="docs-apex/html/APEX-Introduction.html">stand-alone HTML</a> and - <a href="docs-apex/pdf/APEX-Introduction.pdf">stand-alone PDF</a>. - </td> - </tr> - - <tr> - <td><a href="apex-publications.html">Publications</a></td> - <td> - APEX is based on a theor called Unifying Policy Theory (UPT). - Over the years, we have published a number of papers on APEX, context management, policy in general, and control loops. - This is the list of all APEX and the most relevant other publications. - We provide links to full text versions if possible. - - <br /><br /> - Also available as - <a href="docs-apex/html/APEX-Publications.html">stand-alone HTML</a> and - <a href="docs-apex/pdf/APEX-Publications.pdf">stand-alone PDF</a>. - </td> - </tr> - <tr> - <td><a href="user-manual.html">APEX User Manual</a></td> - <td> - The APEX user manual combines a set of guides and howto documents, all supporting the use of APEX. - The guides and howto documents are provided as integrated documentation in the APEX site. - Furthermore, we provide stand-alone documents in HTML and PDF. - </td> - </tr> - <tr> - <td><a href="policy-guide.html">APEX Policy Guide</a></td> - <td> - The APEX policy guide combines a set of howto documents, all supporting APEX and policy, including how to write task and task selection logic. - The howto documents are provided as integrated documentation in the APEX site. - Furthermore, we provide stand-alone documents in HTML and PDF. - </td> - </tr> - <tr> - <td><a href="developer-guide.html">APEX Development Guide</a></td> - <td> - The APEX developer guide combines a set of guides and howto documents, all addressing aspects for APEX developers. - These documents look at APEX internals and how to extend build and extend the platform, and how to add applications. - The guide and howto documents are provided as integrated documentation in the APEX site. - Furthermore, we provide stand-alone documents in HTML and PDF. - </td> - </tr> - </table> - - - <h3>APEX Modules and Projects</h3> - <table> - <tr> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Name</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Description</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Useful for</th> - </tr> - - <tr> - <td><a href="modules/examples/index.html">examples</a></td> - <td> - Example policies and policy models for several use cases, all written for APEX.. - Here one can find complete implementations, examples, and tests for APEX policies. - Important projects here are: - <ul> - <li><a href="modules/examples/examples-decisionmaker/index.html">examples-decisionmaker</a> - A simple decision maker demo, with REST interface for interactions deployed in a Docker container</li> - <li><a href="modules/examples/examples-myfirstpolicy/index.html">examples-myfirstpolicy</a> - My First Policy, a step-by-step tutorial for defining a policy</li> - <li><a href="modules/examples/examples-pcvs/index.html">examples-pcvs</a> - An example policy for managing customers and link failures showing video streaming for a simple VPN scenario</li> - <li><a href="modules/examples/examples-onap-vcpe/index.html">examples-onap-vcpe</a> - An example policy for managing vCPE's in ONAP</li> - <li><a href="modules/examples/examples-periodic/index.html">examples-periodic</a> - An example periodic policy</li> - <li><a href="modules/examples/examples-servlet/index.html">examples-servlet</a> - An APEX Servlet Example</li> - <li><a href="modules/examples/examples-adaptive/index.html">examples-adaptive</a> - A simple adaptive policy</li> - <li><a href="modules/examples/examples-aadm/index.html">examples-aadm</a> - A policy realizing a complex scenario for Autonomic Anomaly Detection and Mitigation (AADM)</li> - </ul> - </td> - <td>Policy Designers, Testers</td> - </tr> - - <tr> - <td><a href="modules/client/index.html">clients</a></td> - <td> - Web clients for APEX, including engine monitoring, policy model deployment, and an HTML-based policy editor. - Important projects here are: - <ul> - <li><a href="modules/client/client-editor/index.html">client-editor</a> - APEX REST Editor</li> - <li><a href="modules/client/client-monitoring/index.html">client-monitoring</a> - APEX Monitoring Client</li> - <li><a href="modules/client/client-deployment/index.html">client-deployment</a> - APEX Deployment Client</li> - <li><a href="modules/client/client-full/index.html">client-full</a> - APEX Full Client</li> - </ul> - </td> - <td>APEX users, Developers, Deployers</td> - </tr> - - <tr> - <td><a href="modules/auth/index.html">auth</a></td> - <td> - Policy, state, and task authoring for APEX. - Important projects here are: - <ul> - <li><a href="modules/auth/cli-editor/index.html">cli-editor</a> - The APEX CLI Editor</li> - <li><a href="modules/auth/cli-codegen/index.html">cli-codegen</a> - Code-generation tools</li> - </ul> - </td> - <td>Policy Designers</td> - </tr> - - <tr> - <td><a href="modules/packages/index.html">packages</a></td> - <td> - The APEX packages, for full deployment (installation package) and Docker deployment. - Important projects here are: - <ul> - <li><a href="modules/packages/apex-pdp-package-full/index.html">package-full</a> - The full deployment module, generates DEB, RPM and TAR deployment artifacts</li> - <li><a href="modules/packages/apex-pdp-docker/index.html">apex-pdp-docker</a> - Creates a Docker deployment artifact</li> - </ul> - </td> - <td>Tester, DevOps, Installers</td> - </tr> - - <tr> - <td><a href="modules/tools/index.html">tools</a></td> - <td> - The APEX applications, implementation dependent wrappers and mediation for APEX in various technologies. - Important projects here are: - <ul> - <li><a href="modules/tools/tools-common/index.html">tools-common</a> - Utilities for APEX application developers</li> - <li><a href="modules/tools/model-generator/index.html">model-generator</a> - Generators from/to the APEX policy mode</li> - <li><a href="modules/tools/simple-wsclient/index.html">simple-wsclient</a> - Simple Websocket clients (console and echo) for trigger/actioning systems</li> - </ul> - </td> - <td>Applications developers, DevOps, Installers</td> - </tr> - - <tr> - <td><a href="modules/plugins/index.html">plugins</a></td> - <td> - Plugins for APEX that can be implemented with various 3PPs are implemented here. - Most of the APEX engine and system functionality is realized using plug-ins. - These plug-ins are loaded when an APEX policy engine is started. - A configuration specifies which plugins to load. - Important projects here are: - <ul> - <li><a href="modules/plugins/plugins-executor/index.html">plugins-executor</a> - Execution environments for policy logic, such as Javascript, Java, JRuby, Jython, MVEL</li> - <li><a href="modules/plugins/plugins-event/index.html">plugins-event</a> - All event-related plugins: carrier technologies (Kafka, Websocket), event protocols (XML, IBeam)</li> - <li><a href="modules/plugins/plugins-context/index.html">plugins-context</a> - Everything for context: schema (for defining context) distribution (across policies and engines), locking (for writing to context items), persistence</li> - <li><a href="modules/plugins/plugins-persistence/index.html">plugins-persistence</a> - Everything needed for persistence (beside context), mainly JPA plugins for Eclipselink and Hibernate</li> - </ul> - </td> - <td>Plugin developers</td> - </tr> - - <tr> - <td><a href="modules/testsuites/index.html">testsuites</a></td> - <td> - APEX testsuites for integration tests, performance tests, and bench marking. - Important projects here are: - <ul> - <li><a href="modules/testsuites/integration/index.html">integration</a> - Packaging for all the Apex components, the engine, the WAR service, and the editor</li> - <li><a href="modules/testsuites/performance/index.html">performance</a> - Packaging for all the Apex components, the engine, the WAR service, and the editor</li> - </ul> - </td> - <td>Service developers, Deployers</td> - </tr> - - <tr> - <td><a href="modules/services/index.html">services</a></td> - <td> - The APEX engine as a service, deployment independent. - Important projects here are: - <ul> - <li><a href="modules/services/services-engine/index.html">services-engine</a> - APEX engine service</li> - </ul> - </td> - <td>Service developers, Deployers</td> - </tr> - - <tr> - <td><a href="modules/core/index.html">core</a></td> - <td> - The core of APEX, deployment independent. - Important projects here are: - <ul> - <li><a href="modules/core/core-engine/index.html">core-engine</a> - The APEX policy execution engine</li> - <li><a href="modules/core/core-infrastructure/index.html">core-infrastructure</a> - Common non-functional components for APEX</li> - <li><a href="modules/core/core-deployment/index.html">core-deployment</a> - The APEX policy deployer</li> - <li><a href="modules/core/core-protocols/index.html">core-protocols</a> - Protocols used to transfer information between components in APEX</li> - </ul> - </td> - <td>Core APEX developers</td> - </tr> - - <tr> - <td><a href="modules/context/index.html">context</a></td> - <td> - The context handling framework of APEX. - Important projects here are: - <ul> - <li><a href="modules/context/context-management/index.html">context-management</a> - Context management for Apex policy execution</li> - <li><a href="modules/context/context-test-utils/index.html">context-test-utils</a> - Test utilities for context</li> - </ul> - </td> - <td>Core APEX developers</td> - </tr> - - <tr> - <td><a href="modules/model/index.html">model</a></td> - <td> - The model for APEX, it comtains definitions of all APEX concepts, also has handling for APEX policy models. - Important projects here are: - <ul> - <li><a href="modules/model/model-api/index.html">model-api</a> - The APEX Model API with programatic access to a policy model</li> - <li><a href="modules/model/basic-model/index.html">basic-model</a> - Basic Models used and model handling in Apex</li> - <li><a href="modules/model/event-model/index.html">event-model</a> - Event Models used in APEX </li> - <li><a href="modules/model/policy-model/index.html">policy-model</a> - Policy Models used in APEX</li> - <li><a href="modules/model/engine-model/index.html">engine-model</a> - Engine Models used in APEX</li> - <li><a href="modules/model/context-model/index.html">context-model</a> - Context Models used in APEX</li> - <li><a href="modules/model/utilities/index.html">model-utilities</a> - Common non-functional Apex Model Utilities</li> - </ul> - </td> - <td>Core APEX developers, Application developers (Model API)</td> - </tr> - </table> - - - <h3>APEX Resources</h3> - <table> - <tr> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Resource</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">Description</th> - </tr> - <tr> - <td><a href="https://gerrit.onap.org/r/#/admin/projects/policy/apex-pdp">APEX Source (ONAP)</a></td> - <td> - The source of APEX is hosted part of the ONAP Policy Framework. - </td> - </tr> - <tr> - <td><a href="https://jira.onap.org/projects/POLICY/issues">APEX Issue Management (ONAP, JIRA)</a></td> - <td> - Issues with the APEX software and integrated documentation are managed here. - This link requires a Linux Foundation ID. - </td> - </tr> - </table> - - </section> - </body> -</document> diff --git a/src/site/xdoc/policy-guide.xml b/src/site/xdoc/policy-guide.xml deleted file mode 100644 index 9167d393a..000000000 --- a/src/site/xdoc/policy-guide.xml +++ /dev/null @@ -1,96 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - ============LICENSE_START======================================================= - Copyright (C) 2016-2018 Ericsson. All rights reserved. - ================================================================================ - This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE - Full license text at https://creativecommons.org/licenses/by/4.0/legalcode - - SPDX-License-Identifier: CC-BY-4.0 - ============LICENSE_END========================================================= - - @author Sven van der Meer (sven.van.der.meer@ericsson.com) - ---> - -<document> - <properties> - <title>The APEX Policy Guide</title> - <author email="sven.van.der.meer@ericsson.com">Sven van der Meer</author> - <author email="liam.fallon@ericsson.com">Liam Fallon</author> - <author email="john.keeney@ericsson.com">John Keeny</author> - </properties> - <body> - - <section name="The APEX Policy Guide"> - - <p> - The APEX policy guide combines a set of howto documents, all supporting APEX and policy, including how to write task and task selection logic. - The howto documents are provided as integrated documentation in the APEX site. - Furthermore, we provide stand-alone documents in HTML and PDF. - </p> - - <p> - Note: most of the documentation is written in AsciiDoc. - We are using the AsciiDoctor version. - Due to the different build tools used for the different documentation targets, the rendered documents differ in style. - The content however comes always from a single, normative source located in the APEX source repositories. - </p> - - <h3>APEX Policy Guide documentation</h3> - <table> - <tr> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="20%">Name</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="50%">Description</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="30%">Links</th> - </tr> - <tr> - <td>Policy Guide</td> - <td> - The complete APEX Policy Guide, including all HowTos and other documentation. - The stand-alone versions aggregate all other documents listed in this table. - </td> - <td> - <ul> - <li><a href="docs-apex/html/APEX-Policy-Guide.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/APEX-Policy-Guide.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - - <tr> - <td>The APEX Policy Model</td> - <td> - A deep dive into the policy model defined and implemented in the APEX engine. - This model is the foundation for policy execution. - </td> - <td> - <ul> - <li><a href="docs-apex/html/Tech-APEX-PolicyModel.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/Tech-APEX-PolicyModel.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - - <tr> - <td>HowTo: Policy Logic</td> - <td> - An APEX policy requires task logic being programmed. - When multiple tasks are combined into a single policy state, a so called task selection logic needs to be programmed as well. - This HowTo explains how to programme policy task logic and if required task selection logic. - </td> - <td> - <ul> - <li><a href="policy-guide/pg-task-logic.html">APEX Site, task logic</a></li> - <li><a href="policy-guide/pg-task-selection-logic.html">APEX Site, task selection logic</a></li> - <li><a href="policy-guide/pg-logic-cheatsheet.html">APEX Site, logic cheatsheet</a></li> - <li><a href="docs-apex/html/HowTo-PolicyLogic.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-PolicyLogic.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - - </table> - </section> - </body> -</document>
\ No newline at end of file diff --git a/src/site/xdoc/user-manual.xml b/src/site/xdoc/user-manual.xml deleted file mode 100644 index 2b34610ff..000000000 --- a/src/site/xdoc/user-manual.xml +++ /dev/null @@ -1,150 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - ============LICENSE_START======================================================= - Copyright (C) 2016-2018 Ericsson. All rights reserved. - ================================================================================ - This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE - Full license text at https://creativecommons.org/licenses/by/4.0/legalcode - - SPDX-License-Identifier: CC-BY-4.0 - ============LICENSE_END========================================================= - - @author Sven van der Meer (sven.van.der.meer@ericsson.com) - ---> - -<document> - <properties> - <title>The APEX User Manual</title> - <author email="sven.van.der.meer@ericsson.com">Sven van der Meer</author> - <author email="liam.fallon@ericsson.com">Liam Fallon</author> - <author email="john.keeney@ericsson.com">John Keeny</author> - </properties> - <body> - - <section name="The APEX User Manual"> - - <p> - The APEX user manual combines a set of guides and howto documents, all supporting the use of APEX. - The guides and howto documents are provided as integrated documentation in the APEX site. - Furthermore, we provide stand-alone documents in HTML and PDF. - </p> - - <p> - Note: most of the documentation is written in AsciiDoc. - We are using the AsciiDoctor version. - Due to the different build tools used for the different documentation targets, the rendered documents differ in style. - The content however comes always from a single, normative source located in the APEX source repositories. - </p> - - <h3>APEX User Manual documentation</h3> - <table> - <tr> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="20%">Name</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="50%">Description</th> - <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em" width="30%">Links</th> - </tr> - <tr> - <td>User Manual</td> - <td> - The complete APEX User Manual, including all HowTos and other documentation. - The stand-alone versions aggregate all other documents listed in this table. - </td> - <td> - <ul> - <li><a href="docs-apex/html/APEX-User-Manual.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/APEX-User-Manual.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>Installation Guide</td> - <td> - The guide with all information on how to get an APEX distribution, install it, configure it, and verify an installation. - The guide describes automatic and manual installations on Unix, Windows, and Cygwin. - It also has a brief description on how to build APEX from source. - </td> - <td> - <ul> - <li><a href="user-manual/install/um-install.html">APEX Site</a></li> - <li><a href="docs-apex/html/APEX-Install-Guide.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/APEX-Install-Guide.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: Configure the APEX Engine</td> - <td> - This HowTo document details all options for configuring an APEX engine. - </td> - <td> - <ul> - <li><a href="user-manual/configuration/um-00-introduction.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-Configuration.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-Configuration.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: Run the APEX engine and the provided applications</td> - <td> - This Howto details the different ways to run an APEX engine. - It also shows how the various provided applications (e.g. CLI Editor, REST Editor, WS clients) can be used. - </td> - <td> - <ul> - <li><a href="user-manual/engine-apps/um-engapps.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-APEX.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-APEX.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: My First Policy</td> - <td> - This HowTo is a step-by-step introduction on how to define a policy. - The document introduces a non-technical retail scenario and analyzes what requirements a policy will have. - Then it shows how a simple policy can be defined, includining all events (trigger and action). - It finished with an extension of this simple policy including some context information. - </td> - <td> - <ul> - <li><a href="user-manual/my-first-policy/um-mfp-01-introduction.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-MyFirstPolicy.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-MyFirstPolicy.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: Logging</td> - <td> - The APEX system uses SLF4j for logging with logback as backend. - This HowTo explains how the logging can be configured for a number of use cases. - </td> - <td> - <ul> - <li><a href="user-manual/logging/um-logging.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-Logging.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-Logging.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - <tr> - <td>HowTo: APEX and Websockets as Carrier Technology</td> - <td> - This HowTo starts with a brief introduction into Websockets in general, including links to open source Java implementations. - Then it explains the different configuration options for an APEX engine when using Websockets. - It finishes with an example configuration using the simple Websocket clients (applications). - </td> - <td> - <ul> - <li><a href="user-manual/websockets/um-websocket-introduction.html">APEX Site</a></li> - <li><a href="docs-apex/html/HowTo-Websockets.html">stand-alone HTML</a></li> - <li><a href="docs-apex/pdf/HowTo-Websockets.pdf">stand-alone PDF</a></li> - </ul> - </td> - </tr> - </table> - </section> - </body> -</document>
\ No newline at end of file |