# ebookfoundation/free-programming-books architecture

> Architecture diagram of the GitHub repository ebookfoundation/free-programming-books, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ebookfoundation/free-programming-books
- Repository: https://github.com/ebookfoundation/free-programming-books

## Overview

This repository is a curated, multilingual catalog of free programming-learning resources, not a conventional application. A reader browses the Markdown lists by resource type, language, or subject; the README also points to a static-site presentation and a separate dynamic search site. The catalog spans books, courses, audio/video resources, and supplementary materials. The graph groups lists by their repository directories; relationships are limited to navigation and access paths explicitly documented in the README.

Main entry points: [`README.md`](https://github.com/ebookfoundation/free-programming-books/blob/main/README.md) (Resource index), [`books`](https://github.com/ebookfoundation/free-programming-books/tree/main/books) (Book lists), [`books/free-programming-books-langs.md`](https://github.com/ebookfoundation/free-programming-books/blob/main/books/free-programming-books-langs.md) (Books by language), [`books/free-programming-books-subjects.md`](https://github.com/ebookfoundation/free-programming-books/blob/main/books/free-programming-books-subjects.md) (Books by subject)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog entry points"]
  node_resource_index["Resource index<br/>[README.md]"]
end

subgraph group_learning["Learning resources"]
  node_book_lists["Book lists"]
  node_book_languages["Books by language"]
  node_book_subjects["Books by subject"]
  node_course_lists["Course lists"]
  node_cast_lists["Podcast and screencast lists"]
end

subgraph group_supplementary["Supplementary resources"]
  node_more_lists["Other resource lists"]
end

subgraph group_access["Reader access"]
  node_static_site["Static site"]
  node_search_site["Dynamic search site"]
end

node_reader(("Reader"))

node_reader -->|"browses"| node_resource_index
node_resource_index -->|"links to"| node_book_lists
node_resource_index -->|"links to"| node_course_lists
node_resource_index -->|"links to"| node_cast_lists
node_resource_index -->|"links to"| node_more_lists
node_resource_index -->|"links to"| node_book_languages
node_resource_index -->|"links to"| node_book_subjects
node_reader -->|"views"| node_static_site
node_reader -->|"searches"| node_search_site

click node_resource_index "https://github.com/ebookfoundation/free-programming-books/blob/main/README.md"
click node_book_lists "https://github.com/ebookfoundation/free-programming-books/tree/main/books"
click node_book_languages "https://github.com/ebookfoundation/free-programming-books/blob/main/books/free-programming-books-langs.md"
click node_book_subjects "https://github.com/ebookfoundation/free-programming-books/blob/main/books/free-programming-books-subjects.md"
click node_course_lists "https://github.com/ebookfoundation/free-programming-books/tree/main/courses"
click node_cast_lists "https://github.com/ebookfoundation/free-programming-books/tree/main/casts"
click node_more_lists "https://github.com/ebookfoundation/free-programming-books/tree/main/more"

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_resource_index toneBlue
class node_book_lists,node_book_languages,node_book_subjects,node_course_lists,node_cast_lists toneAmber
class node_more_lists toneMint
class node_static_site,node_search_site toneRose
class node_reader toneIndigo
```

## Components

### Catalog entry points

- [Resource index](https://github.com/ebookfoundation/free-programming-books/blob/main/README.md): `README.md`

### Learning resources

- [Book lists](https://github.com/ebookfoundation/free-programming-books/tree/main/books): `books`
- [Books by language](https://github.com/ebookfoundation/free-programming-books/blob/main/books/free-programming-books-langs.md): `books/free-programming-books-langs.md`
- [Books by subject](https://github.com/ebookfoundation/free-programming-books/blob/main/books/free-programming-books-subjects.md): `books/free-programming-books-subjects.md`
- [Course lists](https://github.com/ebookfoundation/free-programming-books/tree/main/courses): `courses`
- [Podcast and screencast lists](https://github.com/ebookfoundation/free-programming-books/tree/main/casts): `casts`

### Supplementary resources

- [Other resource lists](https://github.com/ebookfoundation/free-programming-books/tree/main/more): `more`

### Reader access

- **Static site**
- **Dynamic search site**

### Other components

- **Reader**

## Connections

- Reader → Resource index: browses (evidence: `README.md`)
- Resource index → Book lists: links to (evidence: `README.md`)
- Resource index → Course lists: links to (evidence: `README.md`)
- Resource index → Podcast and screencast lists: links to (evidence: `README.md`)
- Resource index → Other resource lists: links to (evidence: `README.md`)
- Resource index → Books by language: links to (evidence: `README.md`)
- Resource index → Books by subject: links to (evidence: `README.md`)
- Reader → Static site: views (evidence: `README.md`)
- Reader → Dynamic search site: searches (evidence: `README.md`)
