Skip to content

Commit 25d2b44

Browse files
author
Frédéric Ferran
committed
Fix the Togaf documentation.
1 parent 9f97634 commit 25d2b44

13 files changed

Lines changed: 184 additions & 204 deletions

‎TogafArchitect/src/main/doc/adoc/Index.adoc‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Togaf-Architect-User-Guide]]
29

310
[[togaf-architect-user-guide]]

‎TogafArchitect/src/main/doc/adoc/Introducing_Installation_and_first_steps.adoc‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Introducing-Installation-and-first-steps]]
29

310
[[introducing-installation-and-first-steps]]

‎TogafArchitect/src/main/doc/adoc/Introducing_Modelio_modules_for_use_with_ModelioTogaf_Architect.adoc‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Modelio-modules-for-use-with-ModelioTogaf-Architect]]
29

310
[[modelio-modules-for-use-with-modeliotogaf-architect]]

‎TogafArchitect/src/main/doc/adoc/Introducing_Togaf.adoc‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Introducing-Togaf]]
29

310
[[introducing-togaf]]
@@ -10,7 +17,7 @@ Welcome to the Togaf Architect user guide.
1017
[[modeling-enterprise-architecture-using-standards]]
1118
===== Modeling enterprise architecture using standards
1219

13-
Enterprise architecture is widely used within large enterprises, but still has significant ground to cover. The heterogeneous use of enterprise architecture through different methods, tools and models is an undeniable barrier to its generalization. And yet standards do exist, both for the approach itself (*TOGAF*, *DODAF*, …) and for modeling (*BPMN*, *UML*,*SysML*, …), and enterprise architecture practices are well known (process analysis, requirements analysis, goal analysis, business rules, …).
20+
Enterprise architecture is widely used within large enterprises, but still has significant ground to cover. The heterogeneous use of enterprise architecture through different methods, tools and models is an undeniable barrier to its generalization. And yet standards do exist, both for the approach itself (*TOGAF*, *DODAF*, ...) and for modeling (*BPMN*, *UML*,*SysML*, ...), and enterprise architecture practices are well known (process analysis, requirements analysis, goal analysis, business rules, ...).
1421

1522
However, each of these standards is a generic toolbox. Any attempt to implement them in a coordinated manner in order to model enterprise architecture requires a great deal of effort, which is beyond most users.
1623

‎TogafArchitect/src/main/doc/adoc/Introducing_the_Togaf_Architect_module.adoc‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Introducing-the-Togaf-Architect-module]]
29

310
[[introducing-the-togaf-architect-module]]

‎TogafArchitect/src/main/doc/adoc/Modeling_Application_modeling.adoc‎

Lines changed: 45 additions & 61 deletions
Large diffs are not rendered by default.

‎TogafArchitect/src/main/doc/adoc/Modeling_Business_modeling.adoc‎

Lines changed: 43 additions & 120 deletions
Large diffs are not rendered by default.

‎TogafArchitect/src/main/doc/adoc/Modeling_Enterprise_Architecture_modeling_with_Modelio.adoc‎

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Modeling-Enterprise-Architecture-modeling-with-Modelio]]
29

310
[[modeling-enterprise-architecture-modeling-with-modelio]]
@@ -27,18 +34,14 @@ In Modelio, you can create an instance (or part) in the deployment location elem
2734

2835
A simpler way to do this in Modelio is just to drag and drop the deployed element (from the explorer) into the deployment location (appearing in a diagram): an instance typed by the deployed element is automatically created.
2936

30-
image:images/Modeling_Enterprise_Architecture_modeling_with_Modelio_ApplicationComponent.png[32]
37+
.Deploying application components under hardware devices (workstation, server)
38+
image::images/Modeling_Enterprise_Architecture_modeling_with_Modelio_ApplicationComponent.png[32]
3139

32-
[[Deploying-application-components-under-hardware-devices-workstation-server]]
3340

34-
[[deploying-application-components-under-hardware-devices-workstation-server.]]
35-
Deploying application components under hardware devices (workstation, server).
41+
.There is a sales department in every location. The Marketing department is only in New York (headquarters)
42+
image::images/Modeling_Enterprise_Architecture_modeling_with_Modelio_Locations.png[33]
3643

37-
image:images/Modeling_Enterprise_Architecture_modeling_with_Modelio_Locations.png[33]
3844

39-
[[There-is-a-sales-department-in-every-location-The-Marketing-department-is-only-in-New-York-headquarters]]
4045

41-
[[there-is-a-sales-department-in-every-location.-the-marketing-department-is-only-in-new-york-headquarters.]]
42-
There is a sales department in every location. The Marketing department is only in New York (headquarters).
4346

4447
[[footer]]

‎TogafArchitect/src/main/doc/adoc/Modeling_Model_Organization.adoc‎

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Model-Organization]]
29

310
[[model-organization]]
@@ -10,11 +17,8 @@ The TOGAF architecture is organized within this structure:
1017
* *Application Architecture* is structured under "application layer/application architecture". It has two application domains: "service data" to model the data exchanged between business services and System Use Cases to model use cases related to the main application components of the IS.
1118
* *Technology Architecture* is structured under the "technology architecture" technology domain.
1219

13-
image:images/Modeling_Model_Organization_TogafTree.png[2]
14-
15-
[[Togaf-structure]]
20+
.Togaf structure
21+
image::images/Modeling_Model_Organization_TogafTree.png[2]
1622

17-
[[togaf-structure]]
18-
Togaf structure
1923

2024
[[footer]]

‎TogafArchitect/src/main/doc/adoc/Modeling_Technology_modeling.adoc‎

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
// Disable all captions for figures.
2+
:!figure-caption:
3+
4+
// Hightlight code source and add the line number
5+
:source-highlighter: coderay
6+
:coderay-linenums-mode: table
7+
18
[[Technology-modeling]]
29

310
[[technology-modeling]]
@@ -16,8 +23,9 @@ An environments and locations diagram depicts which locations host which applica
1623

1724
*Note :* Drag & drop the locations of the enterprise, then drag and drop the material (typically the servers) into the locations, and then drag & drop the application components or software elements into the material. Typically, this diagram represents where each server is located, and on which server which application is executed.
1825

19-
image:images/Modeling_Technology_modeling_image095.gif[image] +
20-
*The main applications and devices are located in Dallas*
26+
.The main applications and devices are located in Dallas
27+
image::images/Modeling_Technology_modeling_image095.gif[image]
28+
2129

2230
[cols=",",options="header",]
2331
|=============================================================================================================================================================================================================================================================================
@@ -45,8 +53,8 @@ This diagram presents the hardware (servers, workstations) that are interconnect
4553

4654
*Note:* Create workstations and servers and connect them using network devices and associations. Then deploy application components by dragging & dropping them into workstations and servers. You can also link roles or actors to their environment.
4755

48-
image:images/Modeling_Technology_modeling_image100.gif[image] +
49-
*This diagram shows where application components are deployed, how the computers are networked, and so on*
56+
.This diagram shows where application components are deployed, how the computers are networked, and so on
57+
image::images/Modeling_Technology_modeling_image100.gif[image]
5058

5159
[cols=",",options="header",]
5260
|=================================================================================================================================================================================================================================================================================================================
@@ -80,8 +88,10 @@ Associations between these deployment units will represent the connection (for e
8088

8189
*Note :* Drag & drop application components to deploy them into the deployable units of configuration, which are themselves specific kinds of application components, at a logical technology level.
8290

83-
image:images/Modeling_Technology_modeling_image103.gif[image] +
84-
*This processing diagram shows how application components are deployed under the different kinds*
91+
92+
.This processing diagram shows how application components are deployed under the different kinds
93+
image::images/Modeling_Technology_modeling_image103.gif[image]
94+
8595

8696
[cols=",",options="header",]
8797
|==================================================================================================================================================================================================================================================

0 commit comments

Comments
 (0)