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 ().

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 ().

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.