# hannotify/javas-concurrency-journey-continues architecture

> Architecture diagram of the GitHub repository hannotify/javas-concurrency-journey-continues, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hannotify/javas-concurrency-journey-continues
- Repository: https://github.com/hannotify/javas-concurrency-journey-continues

## Overview

##### Project type and purpose
- This is a *static slide deck* for a Java conference talk, authored in Markdown and PlantUML, styled with CSS, and rendered into a single-page HTML presentation (index.html). There is no dynamic backend or database—everything is pre-built and served as static assets.

##### Main components
a. Content sources
- sections/\*.md – the talk’s individual slides and sections
- /outline.md – master outline of the deck
- demo/demo.md – demonstration notes
c. Styling assets
- css/\*.css – theme and presentation styles (darcula, devoxx, custom, etc.)
d. Static assets
e. Renderer & final output
f. (Implicit) Build tool
- Could be a script or Pandoc/Reveal.js invocation that:
1. Converts Markdown → HTML slides
2. Invokes PlantUML → out/puml
3. Bundles CSS & images
4. Produces index.html

##### Relationships and data-flow
- Authors edit .md and .puml source files
- Build pipeline step-1: run PlantUML on puml/*.puml → out/puml/*.png (or SVG)
- index.html loads CSS and image assets at runtime in the browser
- Browser renders the slide deck; no server-side logic

##### Architectural patterns & design principles
- *Static Site Generation*: clear separation between content, assets, and final output

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Content Sources (blue)
    subgraph "Content Sources"
        style ContentSources fill:none,stroke:none
        Sections["sections/*.md"]:::content
        Outline["outline/outline.md"]:::content
        Demo["demo/demo.md"]:::content
    end

    %% PUML Sources
    puml_sources["puml/*.puml"]:::content

    %% Build-time Processors (green)
    PlantUML["PlantUML Processor"]:::processor
    out_puml["Rendered Diagrams (out/puml/)"]:::processor
    SlideGen["Slide Generator\n(Pandoc/Reveal.js script)"]:::processor

    %% Assets (orange)
    subgraph "Static Assets"
        styling["css/"]:::assets
        images["img/"]:::assets
    end

    %% Runtime / Hosting (grey)
    index["index.html"]:::runtime
    Hosting["Static Hosting / CDN"]:::runtime
    Browser["Browser Viewer"]:::runtime

    %% Connections
    Sections -->|"compile slides"| SlideGen
    Outline -->|"compile slides"| SlideGen
    Demo -->|"compile slides"| SlideGen

    puml_sources -->|"render diagrams"| PlantUML
    PlantUML --> out_puml
    out_puml -->|"include diagrams"| SlideGen

    SlideGen -->|"produces"| index
    styling -->|"deploy assets"| Hosting
    images -->|"deploy assets"| Hosting
    index -->|"deploy site"| Hosting
    Hosting -->|"serve static files"| Browser

    %% Click Events
    click Sections "https://github.com/hannotify/javas-concurrency-journey-continues/tree/english-60m/sections/"
    click Outline "https://github.com/hannotify/javas-concurrency-journey-continues/blob/english-60m/outline/outline.md"
    click Demo "https://github.com/hannotify/javas-concurrency-journey-continues/blob/english-60m/demo/demo.md"
    click puml_sources "https://github.com/hannotify/javas-concurrency-journey-continues/tree/english-60m/puml/"
    click out_puml "https://github.com/hannotify/javas-concurrency-journey-continues/tree/english-60m/out/puml/"
    click styling "https://github.com/hannotify/javas-concurrency-journey-continues/tree/english-60m/css/"
    click images "https://github.com/hannotify/javas-concurrency-journey-continues/tree/english-60m/img/"
    click index "https://github.com/hannotify/javas-concurrency-journey-continues/blob/english-60m/index.html"

    %% Styles
    classDef content fill:#ADD8E6,stroke:#000;
    classDef processor fill:#90EE90,stroke:#000;
    classDef assets fill:#FFA500,stroke:#000;
    classDef runtime fill:#D3D3D3,stroke:#000;
```
