# ebookfoundation/free-science-books architecture

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

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

## Overview

This repository is a community-curated catalog of free science books, not a software runtime. Readers start at the README and open a language-specific list. Contributors follow the documented fork, edit, and pull-request process. The README documents the language variants and contribution flow; source excerpts were unavailable, so relationships are limited to those explicit links and instructions.

Main entry points: [`README.md`](https://github.com/ebookfoundation/free-science-books/blob/master/README.md) (README index), [`CONTRIBUTING.md`](https://github.com/ebookfoundation/free-science-books/blob/master/CONTRIBUTING.md) (Contribution guidance), [`free-science-books-az.md`](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-az.md) (Azerbaijani list), [`free-science-books-bg.md`](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-bg.md) (Bulgarian list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Catalog navigation"]
  node_readme["README index<br/>[README.md]"]
end

subgraph group_lists["Book lists"]
  node_az["Azerbaijani list"]
  node_bg["Bulgarian list"]
  node_cs["Czech list"]
  node_de["German list"]
  node_es["Spanish list"]
  node_fa["Persian list"]
  node_fr["French list"]
  node_gr["Greek list"]
  node_hu["Hungarian list"]
  node_id["Indonesian list"]
  node_it["Italian list"]
  node_ja["Japanese list"]
  node_ko["Korean list"]
  node_nl["Dutch list"]
  node_pl["Polish list"]
  node_ptbr["Brazilian Portuguese list"]
  node_ptpt["Portuguese list"]
  node_ro["Romanian list"]
  node_ru["Russian list"]
  node_se["Swedish list"]
  node_sk["Slovak list"]
  node_tr["Turkish list"]
  node_ua["Ukrainian list"]
  node_ur["Urdu list"]
  node_zh["Chinese list"]
  node_en["English list"]
end

subgraph group_contribution["Contributions"]
  node_todo["Contribution priorities<br/>[TODO.md]"]
  node_guidance["Contribution guidance<br/>[CONTRIBUTING.md]"]
end

node_reader(("Reader"))
node_contributor(("Contributor"))
node_pull_request(("Pull request"))

node_reader -->|"opens"| node_readme
node_readme -->|"links to"| node_az
node_readme -->|"links to"| node_bg
node_readme -->|"links to"| node_cs
node_readme -->|"links to"| node_de
node_readme -->|"links to"| node_es
node_readme -->|"links to"| node_fa
node_readme -->|"links to"| node_fr
node_readme -->|"links to"| node_gr
node_readme -->|"links to"| node_hu
node_readme -->|"links to"| node_id
node_readme -->|"links to"| node_it
node_readme -->|"links to"| node_ja
node_readme -->|"links to"| node_ko
node_readme -->|"links to"| node_nl
node_readme -->|"links to"| node_pl
node_readme -->|"links to"| node_ptbr
node_readme -->|"links to"| node_ptpt
node_readme -->|"links to"| node_ro
node_readme -->|"links to"| node_ru
node_readme -->|"links to"| node_se
node_readme -->|"links to"| node_sk
node_readme -->|"links to"| node_tr
node_readme -->|"links to"| node_ua
node_readme -->|"links to"| node_ur
node_readme -->|"links to"| node_zh
node_readme -->|"links to"| node_en
node_contributor -->|"reads"| node_readme
node_readme -->|"points to"| node_todo
node_readme -->|"points to"| node_guidance
node_contributor -->|"follows"| node_guidance
node_contributor -->|"submits"| node_pull_request

click node_readme "https://github.com/ebookfoundation/free-science-books/blob/master/README.md"
click node_az "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-az.md"
click node_bg "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-bg.md"
click node_cs "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-cs.md"
click node_de "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-de.md"
click node_es "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-es.md"
click node_fa "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-fa_IR.md"
click node_fr "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-fr.md"
click node_gr "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-gr.md"
click node_hu "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-hu.md"
click node_id "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-id.md"
click node_it "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-it.md"
click node_ja "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ja.md"
click node_ko "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ko.md"
click node_nl "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-nl.md"
click node_pl "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-pl.md"
click node_ptbr "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-pt_BR.md"
click node_ptpt "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-pt_PT.md"
click node_ro "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ro.md"
click node_ru "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ru.md"
click node_se "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-se.md"
click node_sk "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-sk.md"
click node_tr "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-tr.md"
click node_ua "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ua.md"
click node_ur "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ur.md"
click node_zh "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-zh.md"
click node_en "https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books.md"
click node_todo "https://github.com/ebookfoundation/free-science-books/blob/master/TODO.md"
click node_guidance "https://github.com/ebookfoundation/free-science-books/blob/master/CONTRIBUTING.md"

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_readme toneBlue
class node_az,node_bg,node_cs,node_de,node_es,node_fa,node_fr,node_gr,node_hu,node_id,node_it,node_ja,node_ko,node_nl,node_pl,node_ptbr,node_ptpt,node_ro,node_ru,node_se,node_sk,node_tr,node_ua,node_ur,node_zh,node_en toneAmber
class node_todo,node_guidance,node_pull_request toneMint
class node_reader,node_contributor toneIndigo
```

## Components

### Catalog navigation

- [README index](https://github.com/ebookfoundation/free-science-books/blob/master/README.md): `README.md`

### Book lists

- [Azerbaijani list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-az.md): `free-science-books-az.md`
- [Bulgarian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-bg.md): `free-science-books-bg.md`
- [Czech list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-cs.md): `free-science-books-cs.md`
- [German list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-de.md): `free-science-books-de.md`
- [Spanish list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-es.md): `free-science-books-es.md`
- [Persian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-fa_IR.md): `free-science-books-fa_IR.md`
- [French list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-fr.md): `free-science-books-fr.md`
- [Greek list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-gr.md): `free-science-books-gr.md`
- [Hungarian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-hu.md): `free-science-books-hu.md`
- [Indonesian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-id.md): `free-science-books-id.md`
- [Italian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-it.md): `free-science-books-it.md`
- [Japanese list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ja.md): `free-science-books-ja.md`
- [Korean list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ko.md): `free-science-books-ko.md`
- [Dutch list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-nl.md): `free-science-books-nl.md`
- [Polish list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-pl.md): `free-science-books-pl.md`
- [Brazilian Portuguese list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-pt_BR.md): `free-science-books-pt_BR.md`
- [Portuguese list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-pt_PT.md): `free-science-books-pt_PT.md`
- [Romanian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ro.md): `free-science-books-ro.md`
- [Russian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ru.md): `free-science-books-ru.md`
- [Swedish list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-se.md): `free-science-books-se.md`
- [Slovak list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-sk.md): `free-science-books-sk.md`
- [Turkish list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-tr.md): `free-science-books-tr.md`
- [Ukrainian list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ua.md): `free-science-books-ua.md`
- [Urdu list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-ur.md): `free-science-books-ur.md`
- [Chinese list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books-zh.md): `free-science-books-zh.md`
- [English list](https://github.com/ebookfoundation/free-science-books/blob/master/free-science-books.md): `free-science-books.md`

### Contributions

- [Contribution priorities](https://github.com/ebookfoundation/free-science-books/blob/master/TODO.md): `TODO.md`
- [Contribution guidance](https://github.com/ebookfoundation/free-science-books/blob/master/CONTRIBUTING.md): `CONTRIBUTING.md`

### Other components

- **Reader**
- **Contributor**
- **Pull request**

## Connections

- Reader → README index: opens
- README index → Azerbaijani list: links to
- README index → Bulgarian list: links to
- README index → Czech list: links to
- README index → German list: links to
- README index → Spanish list: links to
- README index → Persian list: links to
- README index → French list: links to
- README index → Greek list: links to
- README index → Hungarian list: links to
- README index → Indonesian list: links to
- README index → Italian list: links to
- README index → Japanese list: links to
- README index → Korean list: links to
- README index → Dutch list: links to
- README index → Polish list: links to
- README index → Brazilian Portuguese list: links to
- README index → Portuguese list: links to
- README index → Romanian list: links to
- README index → Russian list: links to
- README index → Swedish list: links to
- README index → Slovak list: links to
- README index → Turkish list: links to
- README index → Ukrainian list: links to
- README index → Urdu list: links to
- README index → Chinese list: links to
- README index → English list: links to
- Contributor → README index: reads
- README index → Contribution priorities: points to
- README index → Contribution guidance: points to
- Contributor → Contribution guidance: follows
- Contributor → Pull request: submits