# Changelog
## 3rd edition (unreleased, since `v2.0.0` on 2025-12-10)
### Structure

- Introduced NaNoPy earlier in the book (13.1 → 9.2) (69d7462).
- Split the chapter "Packages and NumPy" into "Packages" and "NumPy" to make room for earlier NaNoPy integration (93b9b4c, 69d7462).
- Reframed the references to NumPy in "Packages" to `random` instead (dbf217b).
- Renumbered chapters: NumPy 9 → 10, Functions 10 → 11, Data files 11 → 12, Data visualization 12 → 13, Biomolecular simulations 13 → 14 to make room for "Packages" chapter (93b9b4c).
- Moved outro out of Biomolecular simulations chapter to standalone page (f832f17).
- Added page on AI generated code (e00cf03 … ade4e38).
- Added appendix with 8 demos from programming-demos repository (v0.1.5) (194e83e, ff4fdde, bb1d997, 056bd9a).
- Added colophon page (40c4a31, d0959bb, e085a22).
- Changed filename pattern from `chapterN` to `chapter-NN-topic`. Breaks old links (085320c).
- Changed `.ipynb` files without code to `.md` for easier editing and Git tracking (12b71cd).

### Content changes
#### Global content changes
- Updated mind maps (26b8ab9, 92c63e6).
- Small fixes across the book: typos, examples, "molarity" → "moles", variable named `total` instead of `sum` (f759dc3, 8ad9275, 355b7dc, 077114a, 2a83d94, f0350ce).

#### Content changes by chapter
##### Chapter 1: Introduction
- Mention Claude alongside ChatGPT in "AI in learning programming" (ad7dc0f).

##### Chapter 2: Installation
- Replaced Miniconda/Anaconda by Miniforge (conda-forge), with note on Anaconda licensing (0aa6af5).
- Removed gensim from the default environment (<hash>).

##### Chapter 3: Terminal
- Rewrote introduction with images (835612c, a634568).
- Distinguished special symbols from other commands in BASH table (be9bd21).
- Added note on `tree` install for Windows (24115cb).
- Fixed issues in section on file/directory manipulation (e26ece3).
- Updated Vim section with a focus on explainable motions (cc2630f, 0c535db, a19acfc).
- Added file navigation with Vim (4a72a21).

##### Chapter 4: Git
- Added section on commit quality (fc1ef6f).

##### Chapter 6: AI
- Updated the OpenAI API example to the current `openai` library and show it as code instead of a screenshot.
- Added note that gensim is not in the default environment and how to install it (<hash>).

##### Chapter 9: Packages
- Updated NaNoPy usage to set better example for students (8ab1df1, aba70a4, 89da05b).

##### Chapter 12: Data files
- Added `pathlib` explainer (fe9ee80).

### Exercises
- Changed exercises to have single-source-of-truth that is used to rebuild downloadable files (d0ee787, 1e96045, 417690f, 41fd857).
- Spread NaNoPy exercises over book and marked them to be easily identifiable (4892ef4, 318964d, bc633ff).
- Added exercise chapter 3: Moving files relative to each other (f90e16e).
- Added 3 exercises chapter 10: Combining NaNoPy with NumPy (c3fca18, b5e111e, 9df66b9).
- Added exercise chapter 14: Culminating NaNoPy exercise on better particle collisions (f7bb09a).
- Moved some exercises to more appropriate locations (4892ef4, 0b1fcf7).
- Updated the counting of the exercise source files (86dc875, 6da5bb5, 3603675).
- Fixed: Courses exercise (c61aabc).
- Fixed: Different clock exercise (f0350ce).

### Presentation
- Title is now "Programming Foundations" (subtitle dropped) (fe0abd9).
- Quizzes restyled; quiz font matches the book (24b496b, bc1bce9).
- Citations and reference lists in APA 7 style (d6a8b79).
- Sidebar rendering fix (d7cd761).
- PDF: SVG figures are now vector graphics; fixed cropped logos, collapsed whitespace and wrong fonts in Excalidraw figures (1098cda).

### Licensing and attribution
- Colophon with authors, keywords, Use of AI statement, copyright, disclaimer (d0959bb, 3d27464, 0e3aaa2).
- Open-Meteo data attribution (f30e575).
- Demos licensed CC BY 4.0 (069d050).
- Image copyright check: added or completed attributions (Figs. 1.6, 3.5, 4.2, 4.3, 12.1, 12.4–12.9) and cited the penguin dataset (Gorman et al., 2014) (15168c0).
- Replaced third-party or unclear images with own drawings: beaver and quote icon in exercises, Git cycle, particle-collision diagram (15168c0, 30c6a2f, ef56efd).
- Removed GitLab logos from the Git figures (38209e4).
- Python logo is now the official PSF SVG (42caff7).
- Replaced the unofficial ChatGPT logo with an own robot drawing (ad7dc0f).
- Replaced the biofilm illustrations by Johan Slotman in the quorum-sensing demo with own adaptations (programming-demos v0.1.4, v0.1.5).
- Added a Trademarks section to the colophon (c97c685).

### Infrastructure (probably not reader-facing; omit or keep short)
- Python environment managed with `pyproject.toml`/`uv`; separate test environment (2817f32, 2df8945).
- jupyter-book version upgraded and pinned (e34cabb, ef47dde).
- Makefile builds exercise `.zip` files and rendered `.md` (faf9d04, dfd2e46).
- Demos included as git subtree from programming-demos (194e83e).

---

## 2nd edition (`v2.0.0`, 2025-12-10, since `v1.0.0` on 2025-03-03)

### Structure
- Added chapter 6 "AI in programming" (eae9c12 … d624957).
- Added chapter 13 "Biomolecular simulations": 13.1 Graphical environment (NaNoPy), 13.2 Exercises (918caed, 568589e, b3b21e3).
- Moved installation and setup to separate chapter (b7ddd88, 92eb59e).
- Added section 1.2 "Your computer" (files and folders) (821edb2).
- Renumbered chapters accordingly (8a3f8fa).

### Content
- Added AI tips (admonitions) throughout the book (6794da2, db75c5f, 1878d6a).
- Added AI-integration exercises in several chapters: Python basics, good coding practices, NumPy, functions, plotting, biomolecular (238b207 … 60d618f).
- Updated installation: Git Bash replaces Cygwin on Windows; conda environment file; working folder moved out of Documents; video tutorials; SSH/Git setup clarified; Git Bash in VS Code (ee34e99 … 4607a31, 6bd3d8e, 4b165d6).
- Reworked Git introduction with illustrations (377ea23, 5d17147, fd0bbfc).
- Reworked debugging section (e82ec67, e57877f, 3d7a902).
- Revised algorithmic thinking (8466566).
- Revised glossary (8466566).
- Added mind maps (23995b9).
- Added exercises on plot types; difficulty levels for biomolecular exercises (dcecf8d, 68a0a94).
- (Patch) Updated NaNoPy version and fixed bugs (ea05692, 8f64b97, eca1757, b514b9f).

### Presentation and licensing
- Added new logo (587fb08).
- Added AI admonition style (3222b58).
- Removed licence from outro (5e40973).
- Fixed dependency issue for plotting (68184a5).

---

## 1st edition (`v1.0.0`, 2025-03-03)
- Initial release.
