Architectural Diagrams addition to User Guide

[igordayen]

Overview

Diagrams additions:
Sections: Planners, Agent Platform, Agent Process

Please refer to issue:
#40

Implementation

Diagrams got generated using Graphiz in ".dot"-format.

Syntax on inclusion into Asciidoc:

[graphviz, embabel_planning_system.dot, png]
----
include::../diagrams/architecture/embabel_planning_system.dot[]
----

Maven does include proper diagram plugin:

                            <groupId>org.asciidoctor</groupId>
                            <artifactId>asciidoctorj-diagram</artifactId>
                            <version>${asciidoctorj.diagram.version}</version>

We need to test whether this works properly in Github build.

In order to render diagrams in Intellij Kroki should be enabled:

Note on Rendering

if auto-rendering from .dot file is not working properly, will switch to 2-step process on generating svg / png from .dot file

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[alexheifetz]

Let me see if it's buildable on GitHub.

[alexheifetz]

Looks like it's buildable on GitHub with our current doc build setup.

I will merge PR to get it moving forward.

@johnsonr, when get a chance please review arch diagrams for correctness
@jasperblues please review for look and feel compatibility