# ajayavula682/computer-science architecture

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

- Interactive diagram: https://gitdiagram.com/ajayavula682/computer-science
- Repository: https://github.com/ajayavula682/computer-science

## Overview

##### Project type and purpose
- This is a **static website** (curriculum portal) built with a **Jekyll**-style static site generator and deployed via **GitHub Pages**.
- Purpose: host the OSSU Computer Science curriculum, course pages, and supporting documentation (FAQs, CONTRIBUTING, etc.).

##### File structure
- Top-level content directories:
- `coursepages/` — markdown course content (organized by topic).
- `extras/`, `images/` — supplemental content and static assets.
- Root markdown files: `README.md`, `CONTRIBUTING.md`, `FAQ.md`, etc.
- Jekyll/Site framework:
- `_config.yml` — site configuration.
- `_layouts/` — page templates.
- `_includes/` — reusable HTML fragments (header, footer, nav).
- `.github/workflows/` — CI/CD build pipeline.
- Deployment artifacts:
- `CNAME` — custom domain setting.
- `.github/workflows/delete-empty-issues.yml` — housekeeping job.

##### README for additional insights
- Confirms static-site usage by referencing `.github` workflows and listing content organization.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer interactions
    Dev["Developer Workstation"]:::developer
    Dev -->|"push commit"| Repo

    %% Repository subgraph
    subgraph "Source Code Repository"
        direction TB
        Repo["GitHub Repository"]:::managed
        CoursePages["coursepages/"]:::data
        Extras["extras/"]:::data
        Images["images/"]:::data
        Config["_config.yml"]:::managed
        Layouts["_layouts/"]:::managed
        Includes["_includes/"]:::managed
        Workflows[".github/workflows/"]:::managed
        DeleteIssues["delete-empty-issues.yml"]:::managed
        IssueTemplates[".github/ISSUE_TEMPLATE/"]:::managed
        CNAME["CNAME"]:::output
        README["README.md"]:::managed
        Contrib["CONTRIBUTING.md"]:::managed
        FAQ["FAQ.md"]:::managed
        License["LICENSE"]:::managed
        Changelog["CHANGELOG.md"]:::managed

        Repo --> CoursePages
        Repo --> Extras
        Repo --> Images
        Repo --> Config
        Repo --> Layouts
        Repo --> Includes
        Repo --> Workflows
        Workflows --> DeleteIssues
        Repo --> IssueTemplates
        Repo --> README
        Repo --> Contrib
        Repo --> FAQ
        Repo --> License
        Repo --> Changelog
        Repo --> CNAME
    end

    %% Build pipeline
    Workflows -. triggers .-> Actions["GitHub Actions"]:::build
    Actions -->|"runs Jekyll build"| Jekyll["Jekyll Static Site Generator"]:::build
    Jekyll -->|"process markdown + templates"| Artifacts["Static Site Artifacts"]:::build

    %% Deployment and hosting
    Artifacts -->|"deploy to Pages branch"| Pages["GitHub Pages Hosting"]:::output
    Pages -->|"serve site"| Browser["User Browser"]:::external
    Pages -. uses .-> CNAME

    %% Click events
    click CoursePages "https://github.com/ajayavula682/computer-science/tree/master/coursepages/"
    click Extras "https://github.com/ajayavula682/computer-science/tree/master/extras/"
    click Images "https://github.com/ajayavula682/computer-science/tree/master/images/"
    click Config "https://github.com/ajayavula682/computer-science/blob/master/_config.yml"
    click Layouts "https://github.com/ajayavula682/computer-science/tree/master/_layouts/"
    click Includes "https://github.com/ajayavula682/computer-science/tree/master/_includes/"
    click Workflows "https://github.com/ajayavula682/computer-science/tree/master/.github/workflows/"
    click DeleteIssues "https://github.com/ajayavula682/computer-science/blob/master/.github/workflows/delete-empty-issues.yml"
    click IssueTemplates "https://github.com/ajayavula682/computer-science/tree/master/.github/ISSUE_TEMPLATE/"
    click CNAME "https://github.com/ajayavula682/computer-science/tree/master/CNAME"
    click README "https://github.com/ajayavula682/computer-science/blob/master/README.md"
    click Contrib "https://github.com/ajayavula682/computer-science/blob/master/CONTRIBUTING.md"
    click FAQ "https://github.com/ajayavula682/computer-science/blob/master/FAQ.md"
    click License "https://github.com/ajayavula682/computer-science/tree/master/LICENSE"
    click Changelog "https://github.com/ajayavula682/computer-science/blob/master/CHANGELOG.md"

    %% Styles
    classDef managed fill:#AED6F1,stroke:#333,stroke-width:1px
    classDef build fill:#ABEBC6,stroke:#333,stroke-width:1px
    classDef output fill:#F5CBA7,stroke:#333,stroke-width:1px
    classDef data fill:#F9E79F,stroke:#333,stroke-width:1px
    classDef developer fill:#D5D8DC,stroke:#333,stroke-width:1px
    classDef external fill:#E8DAEF,stroke:#333,stroke-width:1px
```
