From 7976680f57725b088850dd32c151c8f267f258f0 Mon Sep 17 00:00:00 2001
From: nils <48135649+Nilstrieb@users.noreply.github.com>
Date: Mon, 27 Jun 2022 08:26:22 +0200
Subject: [PATCH] add doc

---
 doc/crapderive.adoc                      |  88 ++++++++++++++++++
 doc/src/01_introduction_and_goals.adoc   |  22 +++++
 doc/src/02_architecture_constraints.adoc |   5 ++
 doc/src/03_system_scope_and_context.adoc |  24 +++++
 doc/src/04_solution_strategy.adoc        |   5 ++
 doc/src/05_building_block_view.adoc      | 109 +++++++++++++++++++++++
 doc/src/06_runtime_view.adoc             |  18 ++++
 doc/src/07_deployment_view.adoc          |  42 +++++++++
 doc/src/08_concepts.adoc                 |  22 +++++
 doc/src/09_architecture_decisions.adoc   |   5 ++
 doc/src/10_quality_requirements.adoc     |  13 +++
 doc/src/11_technical_risks.adoc          |   5 ++
 doc/src/12_glossary.adoc                 |  15 ++++
 doc/src/about-arc42.adoc                 |  16 ++++
 doc/src/config.adoc                      |   9 ++
 15 files changed, 398 insertions(+)
 create mode 100644 doc/crapderive.adoc
 create mode 100644 doc/src/01_introduction_and_goals.adoc
 create mode 100644 doc/src/02_architecture_constraints.adoc
 create mode 100644 doc/src/03_system_scope_and_context.adoc
 create mode 100644 doc/src/04_solution_strategy.adoc
 create mode 100644 doc/src/05_building_block_view.adoc
 create mode 100644 doc/src/06_runtime_view.adoc
 create mode 100644 doc/src/07_deployment_view.adoc
 create mode 100644 doc/src/08_concepts.adoc
 create mode 100644 doc/src/09_architecture_decisions.adoc
 create mode 100644 doc/src/10_quality_requirements.adoc
 create mode 100644 doc/src/11_technical_risks.adoc
 create mode 100644 doc/src/12_glossary.adoc
 create mode 100644 doc/src/about-arc42.adoc
 create mode 100644 doc/src/config.adoc

diff --git a/doc/crapderive.adoc b/doc/crapderive.adoc
new file mode 100644
index 0000000..3dee586
--- /dev/null
+++ b/doc/crapderive.adoc
@@ -0,0 +1,88 @@
+// header file for arc42-template,
+// including all help texts
+//
+// ====================================
+
+= Crapderive
+// toc-title definition MUST follow document title without blank line!
+:toc-title: Table of Contents
+
+//additional style for arc42 help callouts
+ifdef::backend-html5[]
+++++
+<style>
+.arc42help {font-size:small; width: 14px; height: 16px; overflow: hidden; position: absolute; right: 0; padding: 2px 0 3px 2px;}
+.arc42help::before {content: "?";}
+.arc42help:hover {width:auto; height: auto; z-index: 100; padding: 10px;}
+.arc42help:hover::before {content: "";}
+@media print {
+	.arc42help {display:none;}
+}
+</style>
+++++
+endif::backend-html5[]
+
+// configure EN settings for asciidoc
+include::src/config.adoc[]
+
+
+include::src/about-arc42.adoc[]
+
+// horizontal line
+***
+
+
+
+
+// numbering from here on
+:numbered:
+
+<<<<
+// 1. Introduction and Goals
+include::src/01_introduction_and_goals.adoc[]
+
+<<<<
+// 2. Architecture Constraints
+include::src/02_architecture_constraints.adoc[]
+
+<<<<
+// 3. System Scope and Context
+include::src/03_system_scope_and_context.adoc[]
+
+<<<<
+// 4. Solution Strategy
+include::src/04_solution_strategy.adoc[]
+
+<<<<
+// 5. Building Block View
+include::src/05_building_block_view.adoc[]
+
+<<<<
+// 6. Runtime View
+include::src/06_runtime_view.adoc[]
+
+<<<<
+// 7. Deployment View
+include::src/07_deployment_view.adoc[]
+
+<<<<
+// 8. Concepts
+include::src/08_concepts.adoc[]
+
+<<<<
+// 9. Architecture Decisions
+include::src/09_architecture_decisions.adoc[]
+
+<<<<
+// 10. Quality Requirements
+include::src/10_quality_requirements.adoc[]
+
+<<<<
+// 11. Technical Risks
+include::src/11_technical_risks.adoc[]
+
+<<<<
+// 12. Glossary
+include::src/12_glossary.adoc[]
+
+
diff --git a/doc/src/01_introduction_and_goals.adoc b/doc/src/01_introduction_and_goals.adoc
new file mode 100644
index 0000000..608d505
--- /dev/null
+++ b/doc/src/01_introduction_and_goals.adoc
@@ -0,0 +1,22 @@
+[[section-introduction-and-goals]]
+== Introduction and Goals
+
+
+
+=== Requirements Overview
+
+
+=== Quality Goals
+
+
+
+=== Stakeholders
+
+
+
+[options="header",cols="1,2,2"]
+|===
+|Role/Name|Contact|Expectations
+| _<Role-1>_ | _<Contact-1>_ | _<Expectation-1>_
+| _<Role-2>_ | _<Contact-2>_ | _<Expectation-2>_
+|===
diff --git a/doc/src/02_architecture_constraints.adoc b/doc/src/02_architecture_constraints.adoc
new file mode 100644
index 0000000..335f45d
--- /dev/null
+++ b/doc/src/02_architecture_constraints.adoc
@@ -0,0 +1,5 @@
+[[section-architecture-constraints]]
+== Architecture Constraints
+
+
+
diff --git a/doc/src/03_system_scope_and_context.adoc b/doc/src/03_system_scope_and_context.adoc
new file mode 100644
index 0000000..9193e34
--- /dev/null
+++ b/doc/src/03_system_scope_and_context.adoc
@@ -0,0 +1,24 @@
+[[section-system-scope-and-context]]
+== System Scope and Context
+
+
+
+
+
+=== Business Context
+
+
+
+**<Diagram or Table>**
+
+**<optionally: Explanation of external domain interfaces>**
+
+=== Technical Context
+
+
+
+**<Diagram or Table>**
+
+**<optionally: Explanation of technical interfaces>**
+
+**<Mapping Input/Output to Channels>**
diff --git a/doc/src/04_solution_strategy.adoc b/doc/src/04_solution_strategy.adoc
new file mode 100644
index 0000000..bd50f00
--- /dev/null
+++ b/doc/src/04_solution_strategy.adoc
@@ -0,0 +1,5 @@
+[[section-solution-strategy]]
+== Solution Strategy
+
+
+
diff --git a/doc/src/05_building_block_view.adoc b/doc/src/05_building_block_view.adoc
new file mode 100644
index 0000000..43c5e57
--- /dev/null
+++ b/doc/src/05_building_block_view.adoc
@@ -0,0 +1,109 @@
+[[section-building-block-view]]
+
+
+== Building Block View
+
+
+
+=== Whitebox Overall System
+
+
+
+_**<Overview Diagram>**_
+
+Motivation::
+
+_<text explanation>_
+
+
+Contained Building Blocks::
+_<Description of contained building block (black boxes)>_
+
+Important Interfaces::
+_<Description of important interfaces>_
+
+
+
+
+==== <Name black box 1>
+
+
+
+_<Purpose/Responsibility>_
+
+_<Interface(s)>_
+
+_<(Optional) Quality/Performance Characteristics>_
+
+_<(Optional) Directory/File Location>_
+
+_<(Optional) Fulfilled Requirements>_
+
+_<(optional) Open Issues/Problems/Risks>_
+
+
+
+
+==== <Name black box 2>
+
+_<black box template>_
+
+==== <Name black box n>
+
+_<black box template>_
+
+
+==== <Name interface 1>
+
+...
+
+==== <Name interface m>
+
+
+
+=== Level 2
+
+
+
+==== White Box _<building block 1>_
+
+
+
+_<white box template>_
+
+==== White Box _<building block 2>_
+
+
+_<white box template>_
+
+...
+
+==== White Box _<building block m>_
+
+
+_<white box template>_
+
+
+
+=== Level 3
+
+
+
+
+==== White Box <_building block x.1_>
+
+
+
+
+_<white box template>_
+
+
+==== White Box <_building block x.2_>
+
+_<white box template>_
+
+
+
+==== White Box <_building block y.1_>
+
+_<white box template>_
diff --git a/doc/src/06_runtime_view.adoc b/doc/src/06_runtime_view.adoc
new file mode 100644
index 0000000..f850518
--- /dev/null
+++ b/doc/src/06_runtime_view.adoc
@@ -0,0 +1,18 @@
+[[section-runtime-view]]
+== Runtime View
+
+
+
+
+=== <Runtime Scenario 1>
+
+
+* _<insert runtime diagram or textual description of the scenario>_
+* _<insert description of the notable aspects of the interactions between the
+building block instances depicted in this diagram.>_
+
+=== <Runtime Scenario 2>
+
+=== ...
+
+=== <Runtime Scenario n>
diff --git a/doc/src/07_deployment_view.adoc b/doc/src/07_deployment_view.adoc
new file mode 100644
index 0000000..4c339e3
--- /dev/null
+++ b/doc/src/07_deployment_view.adoc
@@ -0,0 +1,42 @@
+[[section-deployment-view]]
+
+
+== Deployment View
+
+
+
+=== Infrastructure Level 1
+
+
+
+_**<Overview Diagram>**_
+
+Motivation::
+
+_<explanation in text form>_
+
+Quality and/or Performance Features::
+
+_<explanation in text form>_
+
+Mapping of Building Blocks to Infrastructure::
+_<description of the mapping>_
+
+
+=== Infrastructure Level 2
+
+
+
+==== _<Infrastructure Element 1>_
+
+_<diagram + explanation>_
+
+==== _<Infrastructure Element 2>_
+
+_<diagram + explanation>_
+
+...
+
+==== _<Infrastructure Element n>_
+
+_<diagram + explanation>_
diff --git a/doc/src/08_concepts.adoc b/doc/src/08_concepts.adoc
new file mode 100644
index 0000000..a62ef16
--- /dev/null
+++ b/doc/src/08_concepts.adoc
@@ -0,0 +1,22 @@
+[[section-concepts]]
+== Cross-cutting Concepts
+
+
+
+
+
+=== _<Concept 1>_
+
+_<explanation>_
+
+
+
+=== _<Concept 2>_
+
+_<explanation>_
+
+...
+
+=== _<Concept n>_
+
+_<explanation>_
diff --git a/doc/src/09_architecture_decisions.adoc b/doc/src/09_architecture_decisions.adoc
new file mode 100644
index 0000000..d40ca52
--- /dev/null
+++ b/doc/src/09_architecture_decisions.adoc
@@ -0,0 +1,5 @@
+[[section-design-decisions]]
+== Architecture Decisions
+
+
+
diff --git a/doc/src/10_quality_requirements.adoc b/doc/src/10_quality_requirements.adoc
new file mode 100644
index 0000000..e1135b0
--- /dev/null
+++ b/doc/src/10_quality_requirements.adoc
@@ -0,0 +1,13 @@
+[[section-quality-scenarios]]
+== Quality Requirements
+
+
+
+
+=== Quality Tree
+
+
+
+=== Quality Scenarios
+
+
diff --git a/doc/src/11_technical_risks.adoc b/doc/src/11_technical_risks.adoc
new file mode 100644
index 0000000..9680417
--- /dev/null
+++ b/doc/src/11_technical_risks.adoc
@@ -0,0 +1,5 @@
+[[section-technical-risks]]
+== Risks and Technical Debts
+
+
+
diff --git a/doc/src/12_glossary.adoc b/doc/src/12_glossary.adoc
new file mode 100644
index 0000000..b95c26a
--- /dev/null
+++ b/doc/src/12_glossary.adoc
@@ -0,0 +1,15 @@
+[[section-glossary]]
+== Glossary
+
+
+
+[cols="e,2e" options="header"]
+|===
+|Term |Definition
+
+|<Term-1>
+|<definition-1>
+
+|<Term-2>
+|<definition-2>
+|===
diff --git a/doc/src/about-arc42.adoc b/doc/src/about-arc42.adoc
new file mode 100644
index 0000000..acc5fe1
--- /dev/null
+++ b/doc/src/about-arc42.adoc
@@ -0,0 +1,16 @@
+:homepage: https://arc42.org
+
+:keywords: software-architecture, documentation, template, arc42
+
+:numbered!:
+**About arc42**
+
+[role="lead"]
+arc42, the Template for documentation of software and system architecture.
+
+Created and maintained by Dr. Peter Hruschka, Dr. Gernot Starke and contributors.
+
+Template Revision: 8.0 EN (based on asciidoc), February 2022
+
+(C)
+We acknowledge that this document uses material from the arc 42 architecture template, https://arc42.org.
diff --git a/doc/src/config.adoc b/doc/src/config.adoc
new file mode 100644
index 0000000..334d529
--- /dev/null
+++ b/doc/src/config.adoc
@@ -0,0 +1,9 @@
+// asciidoc settings for EN (English)
+// ==================================
+:toc-title: table of contents
+
+// enable table-of-contents
+:toc:
+
+// where are images located?
+:imagesdir: ./images