# milanm/dotnet-developer-roadmap architecture

> Architecture diagram of the GitHub repository milanm/dotnet-developer-roadmap, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/milanm/dotnet-developer-roadmap
- Repository: https://github.com/milanm/dotnet-developer-roadmap

## Overview

##### Project type & purpose
- This is a **static documentation site** (Markdown + images + PDFs) serving a “.NET Developer Roadmap” guide.
- Key artifacts: README.md (primary content), roadmap images (PNG), downloadable PDFs, and links to external resources (Patreon, newsletter).
- Users consume the content via a web browser (e.g., GitHub Pages or a similar static‐site host).

##### File structure
- Top level:
- README.md – main content
- NET Roadmap.pdf / NET Developer Roadmap Minimal.pdf – compiled guides
- Images (Bundle.png, roadmap PNGs) used inline in the docs
- LICENSE, .gitignore – metadata
- No runtime code, no frontend/backend folders, no compiled binaries—this is purely content.

##### README
- Confirms it is a **learning resource** with embedded images, downloadable PDFs, and external links.
- No mention of a dynamic server, database, or APIs.

##### Main components
a. Source Content Repository (GitHub)
- Markdown files

- Image assets

- PDF source files
b. Build Pipeline (CI/CD)
- Static‐Site Generator (e.g., Jekyll, Hugo, or GitHub Pages engine) or a Markdown→HTML tool
- PDF bundling process (if automated)
c. Hosting / CDN
- GitHub Pages or another static hosting (Azure Static Web Apps, Netlify)
- CDN layer for assets (optional)
d. End Users
- Web browsers requesting HTML, images, PDF downloads
e. External Services
- Patreon (for paid bundle purchases)

- Newsletter platform (subscription form)

- Analytics (optional, e.g., Google Analytics)

- GitHub (issue tracker, PRs)

##### Relationships & data flow
- Developer pushes updates → GitHub repo
- Push triggers CI/CD pipeline → runs SSG → generates HTML/CSS/JS + PDFs
- Artifacts deployed to Hosting/CDN
- End user browser → requests HTML, images, PDF downloads
- External links embedded in HTML connect users to Patreon/newsletter
- Optionally: Web analytics collect usage data

##### Architectural patterns & design principles
- **Content‐as‐code**: Versioned Markdown + assets in Git
- **CI/CD pattern**: Automated build & deploy on commit
- **Static site delivery**: Fast, globally cached, no server logic
- **Single responsibility**: README.md owns content; GitHub Actions owns build/deploy

##### Technologies & frameworks
- GitHub & GitHub Actions (or alternative CI/CD)
- Static‐Site Generator (Jekyll, Hugo, or native Markdown renderer)
- GitHub Pages / Azure Static Web Apps / Netlify
- Markdown, HTML, CSS
- PDF generation tool (Pandoc or custom scripts)
- CDN (optional, e.g., Cloudflare)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Source Content Repository
    subgraph "Source Content Repository"
        direction TB
        RepoRoot["Root Directory"]:::repo
        MD["README.md"]:::repo
        Gitignore[".gitignore"]:::repo
        License["LICENSE"]:::repo
        PDF1["NET Roadmap.pdf"]:::repo
        PDF2["NET Developer Roadmap Minimal.pdf"]:::repo
    end

    %% CI/CD and Build
    Pipeline["CI/CD Pipeline"]:::build
    SSG["Static Site Generator"]:::build
    PDFGen["PDF Generation"]:::build

    %% Hosting / CDN
    subgraph "Hosting / CDN"
        direction TB
        Host["GitHub Pages / Static Host"]:::host
        CDN["CDN (optional)"]:::host
    end

    %% Actors and External Services
    Dev["Developer"]:::external
    User["End Users (Browser)"]:::external

    subgraph "External Services"
        direction TB
        Patreon["Patreon"]:::external
        Newsletter["Newsletter Platform"]:::external
        Analytics["Analytics (e.g., GA)"]:::external
    end

    %% Relationships
    Dev -->|"push"| RepoRoot
    RepoRoot -->|"trigger build"| Pipeline
    Pipeline -->|"build site"| SSG
    Pipeline -->|"generate PDFs"| PDFGen
    Pipeline -->|"deploy artifacts"| Host
    SSG -->|"output HTML/CSS/JS"| Host
    PDFGen -->|"output PDFs"| Host
    Host -->|"served via"| CDN
    User -->|"request content"| CDN
    CDN -->|"deliver content"| User
    User -->|"click external link"| Patreon
    User -->|"click external link"| Newsletter
    Host -->|"embed analytics code"| Analytics
    User -->|"send usage data"| Analytics

    %% Click Events
    click MD "https://github.com/milanm/dotnet-developer-roadmap/blob/main/README.md"
    click Gitignore "https://github.com/milanm/dotnet-developer-roadmap/blob/main/.gitignore"
    click License "https://github.com/milanm/dotnet-developer-roadmap/tree/main/LICENSE"
    click PDF1 "https://github.com/milanm/dotnet-developer-roadmap/blob/main/NET Roadmap.pdf"
    click PDF2 "https://github.com/milanm/dotnet-developer-roadmap/blob/main/NET Developer Roadmap Minimal.pdf"

    %% Styles
    classDef repo fill:#D6EAF8,stroke:#3498DB,stroke-width:2px;
    classDef build fill:#D5F5E3,stroke:#27AE60,stroke-width:2px;
    classDef host fill:#FAD7A0,stroke:#E67E22,stroke-width:2px;
    classDef external fill:#E5E7E9,stroke:#7F8C8D,stroke-width:2px;
```
