# swisskyrepo/internalallthethings architecture

> Architecture diagram of the GitHub repository swisskyrepo/internalallthethings, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swisskyrepo/internalallthethings
- Repository: https://github.com/swisskyrepo/internalallthethings

## Overview

##### Project type and purpose
- This is a static documentation site built with MkDocs (“Internal All The Things”).
- Purpose: host and organize a large collection of Active Directory and internal pentest cheatsheets, CVE write-ups, cloud and DevOps guidance, etc.

##### File structure
- mkdocs.yml: top-level config for the site (nav, theme, plugins, deploy targets).
- docs/: all the Markdown source pages, arranged by domain (active-directory, cloud, redteam, etc.).
- assets/: images and media referenced from docs.
- overrides/: custom HTML templates (theme overrides).
- .github/workflows/: CI definitions for building and deploying the site (check-markdown, mkdocs-build).
- README.md: project description and contribution guidelines.

##### README for additional insights
- Confirms static site, versioned via Git, hosted (GitHub Pages).
- Mentions a web version at swisskyrepo.github.io/InternalAllTheThings.
- No dynamic backend or database: pure SSG.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Git Repository and Content
    subgraph "Git Repository"
        RepoRoot["Repo Root"]:::repo
        Readme["README.md"]:::repo
        MkdocsYml["mkdocs.yml"]:::generator
        Docs["docs/"]:::repo
        Assets["assets/"]:::repo
        Overrides["overrides/"]:::repo
        subgraph ".github/"
            CheckYaml["check-markdown.yml"]:::pipeline
            BuildYaml["mkdocs-build.yml"]:::pipeline
            LintConfig[".markdownlint.json"]:::pipeline
        end
    end

    %% CI/CD Pipeline
    CheckYaml -->|"runs on push"| LintJob["Markdown Lint"]:::pipeline
    LintConfig --> LintJob
    LintJob -->|"on success"| BuildJob["MkDocs Build"]:::generator
    BuildYaml --> BuildJob

    %% Build Inputs
    Docs --> BuildJob
    Assets --> BuildJob
    Overrides --> BuildJob
    MkdocsYml --> BuildJob

    %% Deployment
    BuildJob -->|"generate artifacts"| BuildArtifacts["Static Site Artifacts"]:::hosting
    BuildArtifacts -->|"publish gh-pages"| GitHubPages["GitHub Pages"]:::hosting

    %% User Access
    User["End User Browser"]:::user
    User <-->|"HTTPS"| GitHubPages

    %% Click Events
    click RepoRoot "https://github.com/swisskyrepo/internalallthethings/blob/main/."
    click Readme "https://github.com/swisskyrepo/internalallthethings/blob/main/README.md"
    click MkdocsYml "https://github.com/swisskyrepo/internalallthethings/blob/main/mkdocs.yml"
    click Docs "https://github.com/swisskyrepo/internalallthethings/tree/main/docs/"
    click Assets "https://github.com/swisskyrepo/internalallthethings/tree/main/assets/"
    click Overrides "https://github.com/swisskyrepo/internalallthethings/tree/main/overrides/"
    click CheckYaml "https://github.com/swisskyrepo/internalallthethings/blob/main/.github/workflows/check-markdown.yml"
    click BuildYaml "https://github.com/swisskyrepo/internalallthethings/blob/main/.github/workflows/mkdocs-build.yml"
    click LintConfig "https://github.com/swisskyrepo/internalallthethings/blob/main/.github/.markdownlint.json"

    %% Style Definitions
    classDef repo fill:#D0E6FF,stroke:#004080,stroke-width:1px
    classDef pipeline fill:#FFDDC1,stroke:#994C00,stroke-width:1px
    classDef generator fill:#E6CCFF,stroke:#660099,stroke-width:1px
    classDef hosting fill:#C8E6C9,stroke:#257A1E,stroke-width:1px
    classDef user fill:#F0F0F0,stroke:#666666,stroke-width:1px
```
