summaryrefslogtreecommitdiffstats
path: root/src/site/xdoc/developer-guide.xml
blob: 40e689739deb57711aba95f5591055aaa3f5826d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
<?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>