# ntudeepspeed/recruitment_hackathon_2627 architecture

> Architecture diagram of the GitHub repository ntudeepspeed/recruitment_hackathon_2627, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ntudeepspeed/recruitment_hackathon_2627
- Repository: https://github.com/ntudeepspeed/recruitment_hackathon_2627

## Overview

This branch is the documentation front end for the racing hackathon, not the racing software. Its principal workflow is to combine track-branch Markdown and site configuration into a static, multi-track guide, then let readers browse chapters and use platform-aware commands and page controls. The README documents several generator behaviors not visible in the partial build.py excerpt; those are represented at the documented subsystem level. Publishing and link-checking machinery are excluded.

Main entry points: [`docs-site/build.py`](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/build.py) (Site generator), [`docs-site/theme/docs.css`](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/docs.css) (Docs styling), [`README.md`](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/README.md) (Track content), [`docs-site/site.json`](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/site.json) (Site config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assembly["Site assembly"]
  node_track_content["Track content<br/>[README.md]"]
  node_site_config["Site config<br/>[site.json]"]
  node_generator["Site generator<br/>[build.py]"]
  node_templates["Page templates"]
  node_static_assets["Static assets"]
end

subgraph group_presentation["Site presentation"]
  node_generated_site["Static site"]
  node_design_tokens["Design tokens<br/>[tokens.css]"]
  node_docs_styles["Docs styling<br/>[docs.css]"]
  node_slides_pdf["Info slides"]
end

subgraph group_interaction["Reader interactions"]
  node_browser_script["Page behavior<br/>[app.js]"]
end

node_reader(("Reader"))
node_browser(("Web browser"))
node_clipboard["Clipboard"]

node_track_content -->|"reads Markdown"| node_generator
node_site_config -->|"configures build"| node_generator
node_templates -->|"provides shells"| node_generator
node_static_assets -->|"copies assets"| node_generator
node_generator -->|"renders pages"| node_generated_site
node_generated_site -->|"serves pages"| node_browser
node_design_tokens -->|"defines tokens"| node_docs_styles
node_docs_styles -->|"styles pages"| node_browser
node_browser_script -->|"wires controls"| node_browser
node_reader -->|"browses site"| node_browser
node_browser -->|"copies code"| node_clipboard
node_browser -->|"loads on request"| node_slides_pdf

click node_track_content "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/README.md"
click node_site_config "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/site.json"
click node_generator "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/build.py"
click node_templates "https://github.com/ntudeepspeed/recruitment_hackathon_2627/tree/main/docs-site/templates"
click node_static_assets "https://github.com/ntudeepspeed/recruitment_hackathon_2627/tree/main/docs-site/static"
click node_design_tokens "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/tokens.css"
click node_docs_styles "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/docs.css"
click node_browser_script "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/app.js"
click node_slides_pdf "https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/static/deepspeed-info-talk-17-sep-2026.pdf"

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_track_content,node_site_config,node_generator,node_templates,node_static_assets,node_browser toneBlue
class node_generated_site,node_design_tokens,node_docs_styles,node_slides_pdf toneAmber
class node_browser_script toneMint
class node_reader,node_clipboard toneIndigo
```

## Components

### Site assembly

- [Track content](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/README.md): `README.md`
- [Site config](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/site.json): `docs-site/site.json`
- [Site generator](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/build.py): `docs-site/build.py`
- [Page templates](https://github.com/ntudeepspeed/recruitment_hackathon_2627/tree/main/docs-site/templates): `docs-site/templates`
- [Static assets](https://github.com/ntudeepspeed/recruitment_hackathon_2627/tree/main/docs-site/static): `docs-site/static`

### Site presentation

- **Static site**
- [Design tokens](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/tokens.css): `docs-site/theme/tokens.css`
- [Docs styling](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/docs.css): `docs-site/theme/docs.css`
- [Info slides](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/static/deepspeed-info-talk-17-sep-2026.pdf): `docs-site/static/deepspeed-info-talk-17-sep-2026.pdf`

### Reader interactions

- [Page behavior](https://github.com/ntudeepspeed/recruitment_hackathon_2627/blob/main/docs-site/theme/app.js): `docs-site/theme/app.js`

### Other components

- **Reader**
- **Web browser**
- **Clipboard**

## Connections

- Track content → Site generator: reads Markdown
- Site config → Site generator: configures build
- Page templates → Site generator: provides shells
- Static assets → Site generator: copies assets
- Site generator → Static site: renders pages
- Static site → Web browser: serves pages
- Design tokens → Docs styling: defines tokens
- Docs styling → Web browser: styles pages
- Page behavior → Web browser: wires controls
- Reader → Web browser: browses site
- Web browser → Clipboard: copies code
- Web browser → Info slides: loads on request