# simatic-ax/learning-path architecture

> Architecture diagram of the GitHub repository simatic-ax/learning-path, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/simatic-ax/learning-path
- Repository: https://github.com/simatic-ax/learning-path

## Overview

This repository is a Siemens SIMATIC AX learning path: learners work through chapter presentations and accompanying exercises, from AX fundamentals to commissioning and package management. The README documents cloning or downloading the materials and launching a chapter presentation with `apax present`, which starts Reveal.md. The graph preserves the major chapter and exercise areas visible in the tree; source excerpts were not provided, so relationships beyond those documented in the README are omitted.

Main entry points: [`README.md`](https://github.com/simatic-ax/learning-path/blob/main/README.md) (Learning Path), [`00_introduction/slides/slides.md`](https://github.com/simatic-ax/learning-path/blob/main/00_introduction/slides/slides.md) (AX Introduction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fundamentals["AX Fundamentals"]
  node_learning_path["Learning Path<br/>[README.md]"]
  node_introduction["AX Introduction<br/>[slides.md]"]
  node_ax_code["AX Code<br/>[slides.md]"]
  node_external_chapters["Moved Chapters"]
end

subgraph group_engineering["Engineering Practice"]
  node_hardware["Hardware Setup<br/>[slides.md]"]
  node_loading_debugging["Load and Debug<br/>[slides.md]"]
  node_first_exercise["First Exercise<br/>[README.md]"]
  node_commissioning["Commissioning Tools<br/>[slides.md]"]
  node_commissioning_exercise["Commissioning Exercise<br/>[README.md]"]
end

subgraph group_software["Software Skills"]
  node_oop["OOP in ST<br/>[slides.md]"]
  node_valve_exercise["Valve Exercises<br/>[README.md]"]
  node_interfaces_exercise["Interfaces Exercise<br/>[README.md]"]
  node_volume_exercise["Volume Exercise<br/>[README.md]"]
  node_inheritance_exercise["Inheritance Exercise<br/>[README.md]"]
  node_oop_solution["OOP Solution<br/>[README.md]"]
  node_unit_testing["Unit Testing<br/>[slides.md]"]
  node_testing_exercises["Testing Exercises<br/>[README.md]"]
end

subgraph group_ecosystem["AX Ecosystem"]
  node_package_management["Package Management<br/>[slides.md]"]
  node_library_exercise["Library Creation<br/>[README.md]"]
  node_publishing_exercise["Library Publishing<br/>[README.md]"]
  node_consuming_exercise["Library Consumption<br/>[README.md]"]
end

node_learner(("Learner"))
node_reveal_md["Reveal.md"]

node_learner -->|"gets materials"| node_learning_path
node_learner -->|"starts presentation"| node_introduction
node_introduction -->|"starts with"| node_reveal_md
node_learning_path -->|"notes moved chapters"| node_external_chapters

click node_learning_path "https://github.com/simatic-ax/learning-path/blob/main/README.md"
click node_introduction "https://github.com/simatic-ax/learning-path/blob/main/00_introduction/slides/slides.md"
click node_ax_code "https://github.com/simatic-ax/learning-path/blob/main/01_introduction_to_ax_code/slides/slides.md"
click node_hardware "https://github.com/simatic-ax/learning-path/blob/main/03_hardware_configuration/slides/slides.md"
click node_loading_debugging "https://github.com/simatic-ax/learning-path/blob/main/04_loading_and_debugging/slides/slides.md"
click node_first_exercise "https://github.com/simatic-ax/learning-path/blob/main/04_loading_and_debugging/exercises/0_first_exercise/README.md"
click node_oop "https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/slides/slides.md"
click node_valve_exercise "https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/0_basic_valve_class/README.md"
click node_interfaces_exercise "https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/1_interfaces/README.md"
click node_volume_exercise "https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/3_calculator_current_volume/README.md"
click node_inheritance_exercise "https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/4_inheritance_complex_valve/README.md"
click node_oop_solution "https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/solution/README.md"
click node_unit_testing "https://github.com/simatic-ax/learning-path/blob/main/07_unit_testing/slides/slides.md"
click node_testing_exercises "https://github.com/simatic-ax/learning-path/blob/main/07_unit_testing/exercises/1_starting_tests/README.md"
click node_commissioning "https://github.com/simatic-ax/learning-path/blob/main/08_tools_for_commissioning/slides/slides.md"
click node_commissioning_exercise "https://github.com/simatic-ax/learning-path/blob/main/08_tools_for_commissioning/exercises/0_first_exercise/README.md"
click node_package_management "https://github.com/simatic-ax/learning-path/blob/main/09_package_management/slides/slides.md"
click node_library_exercise "https://github.com/simatic-ax/learning-path/blob/main/09_package_management/exercises/1_creating_and_testing_a_library/README.md"
click node_publishing_exercise "https://github.com/simatic-ax/learning-path/blob/main/09_package_management/exercises/2_publishing_a_library/README.md"
click node_consuming_exercise "https://github.com/simatic-ax/learning-path/blob/main/09_package_management/exercises/3_consuming_a_library/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_learning_path,node_introduction,node_ax_code,node_external_chapters toneBlue
class node_hardware,node_loading_debugging,node_first_exercise,node_commissioning,node_commissioning_exercise toneAmber
class node_oop,node_valve_exercise,node_interfaces_exercise,node_volume_exercise,node_inheritance_exercise,node_oop_solution,node_unit_testing,node_testing_exercises toneMint
class node_package_management,node_library_exercise,node_publishing_exercise,node_consuming_exercise toneRose
class node_learner,node_reveal_md toneIndigo
```

## Components

### AX Fundamentals

- [Learning Path](https://github.com/simatic-ax/learning-path/blob/main/README.md): `README.md`
- [AX Introduction](https://github.com/simatic-ax/learning-path/blob/main/00_introduction/slides/slides.md): `00_introduction/slides/slides.md`
- [AX Code](https://github.com/simatic-ax/learning-path/blob/main/01_introduction_to_ax_code/slides/slides.md): `01_introduction_to_ax_code/slides/slides.md`
- **Moved Chapters**

### Engineering Practice

- [Hardware Setup](https://github.com/simatic-ax/learning-path/blob/main/03_hardware_configuration/slides/slides.md): `03_hardware_configuration/slides/slides.md`
- [Load and Debug](https://github.com/simatic-ax/learning-path/blob/main/04_loading_and_debugging/slides/slides.md): `04_loading_and_debugging/slides/slides.md`
- [First Exercise](https://github.com/simatic-ax/learning-path/blob/main/04_loading_and_debugging/exercises/0_first_exercise/README.md): `04_loading_and_debugging/exercises/0_first_exercise/README.md`
- [Commissioning Tools](https://github.com/simatic-ax/learning-path/blob/main/08_tools_for_commissioning/slides/slides.md): `08_tools_for_commissioning/slides/slides.md`
- [Commissioning Exercise](https://github.com/simatic-ax/learning-path/blob/main/08_tools_for_commissioning/exercises/0_first_exercise/README.md): `08_tools_for_commissioning/exercises/0_first_exercise/README.md`

### Software Skills

- [OOP in ST](https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/slides/slides.md): `06_oop_in_st/slides/slides.md`
- [Valve Exercises](https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/0_basic_valve_class/README.md): `06_oop_in_st/exercises/0_basic_valve_class/README.md`
- [Interfaces Exercise](https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/1_interfaces/README.md): `06_oop_in_st/exercises/1_interfaces/README.md`
- [Volume Exercise](https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/3_calculator_current_volume/README.md): `06_oop_in_st/exercises/3_calculator_current_volume/README.md`
- [Inheritance Exercise](https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/4_inheritance_complex_valve/README.md): `06_oop_in_st/exercises/4_inheritance_complex_valve/README.md`
- [OOP Solution](https://github.com/simatic-ax/learning-path/blob/main/06_oop_in_st/exercises/solution/README.md): `06_oop_in_st/exercises/solution/README.md`
- [Unit Testing](https://github.com/simatic-ax/learning-path/blob/main/07_unit_testing/slides/slides.md): `07_unit_testing/slides/slides.md`
- [Testing Exercises](https://github.com/simatic-ax/learning-path/blob/main/07_unit_testing/exercises/1_starting_tests/README.md): `07_unit_testing/exercises/1_starting_tests/README.md`

### AX Ecosystem

- [Package Management](https://github.com/simatic-ax/learning-path/blob/main/09_package_management/slides/slides.md): `09_package_management/slides/slides.md`
- [Library Creation](https://github.com/simatic-ax/learning-path/blob/main/09_package_management/exercises/1_creating_and_testing_a_library/README.md): `09_package_management/exercises/1_creating_and_testing_a_library/README.md`
- [Library Publishing](https://github.com/simatic-ax/learning-path/blob/main/09_package_management/exercises/2_publishing_a_library/README.md): `09_package_management/exercises/2_publishing_a_library/README.md`
- [Library Consumption](https://github.com/simatic-ax/learning-path/blob/main/09_package_management/exercises/3_consuming_a_library/README.md): `09_package_management/exercises/3_consuming_a_library/README.md`

### Other components

- **Learner**
- **Reveal.md**

## Connections

- Learner → Learning Path: gets materials (evidence: `README.md`)
- Learner → AX Introduction: starts presentation (evidence: `README.md`)
- AX Introduction → Reveal.md: starts with (evidence: `README.md`)
- Learning Path → Moved Chapters: notes moved chapters (evidence: `README.md`)
