From 2b08e3d8c4322f3cde4d3e185f4e54f167ca6211 Mon Sep 17 00:00:00 2001 From: Nicholas Karlson Date: Wed, 14 Jan 2026 02:43:26 -0800 Subject: [PATCH 1/2] Docs: include all workbook pages in toctrees (fix docs-strict warnings) --- docs/source/workbook/index.rst | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/docs/source/workbook/index.rst b/docs/source/workbook/index.rst index f4f62fd..5ceb431 100644 --- a/docs/source/workbook/index.rst +++ b/docs/source/workbook/index.rst @@ -10,8 +10,12 @@ This workbook teaches *intro* financial accounting using a simple hybrid workflo 2. Verify your work with LedgerLoom (strict, deterministic). 3. Reconcile any differences until they match (proof, not vibes). +Start here +---------- + .. toctree:: :maxdepth: 2 + :titlesonly: :caption: Start here student_quick_start @@ -21,9 +25,13 @@ This workbook teaches *intro* financial accounting using a simple hybrid workflo workbook_artifacts_reference workbook_troubleshooting +Chapters (Ch01–Ch04) +-------------------- + .. toctree:: :maxdepth: 1 - :caption: Workbook chapters (hybrid method) + :titlesonly: + :caption: Chapters ch01_startup ch01_equation_transaction @@ -31,8 +39,14 @@ This workbook teaches *intro* financial accounting using a simple hybrid workflo ch03_adjusting_entries ch04_closing_and_post_close +Optional tracks and packs +------------------------- + +These pages are optional “side quests” (helpful, but not required to finish Ch01–Ch04). + .. toctree:: - :maxdepth: 2 + :maxdepth: 1 + :titlesonly: :caption: Optional tracks and packs workbook_spreadsheet_first_overview From 133a2165ffba7340bf72b2519fa065b249d5a3ef Mon Sep 17 00:00:00 2001 From: Nicholas Karlson Date: Wed, 14 Jan 2026 02:44:00 -0800 Subject: [PATCH 2/2] Docs: fix workbook nav (chapter titles + titles-only sidebar) --- docs/source/workbook/ch01_equation_transaction.rst | 3 +++ docs/source/workbook/ch01_startup.rst | 3 +++ docs/source/workbook/ch02_journal_to_trial_balance.rst | 3 +++ docs/source/workbook/ch03_adjusting_entries.rst | 3 +++ docs/source/workbook/ch04_closing_and_post_close.rst | 3 +++ 5 files changed, 15 insertions(+) diff --git a/docs/source/workbook/ch01_equation_transaction.rst b/docs/source/workbook/ch01_equation_transaction.rst index fc0b800..82ba7eb 100644 --- a/docs/source/workbook/ch01_equation_transaction.rst +++ b/docs/source/workbook/ch01_equation_transaction.rst @@ -1,3 +1,6 @@ +Ch01B — Accounting equation + transactions +============================================ + What you'll learn ----------------- - Describe how each business event changes A / L / E diff --git a/docs/source/workbook/ch01_startup.rst b/docs/source/workbook/ch01_startup.rst index a07a774..9ea4213 100644 --- a/docs/source/workbook/ch01_startup.rst +++ b/docs/source/workbook/ch01_startup.rst @@ -1,3 +1,6 @@ +Ch01A — Startup +================= + What you'll learn ----------------- - Install LedgerLoom from PyPI (student workflow) diff --git a/docs/source/workbook/ch02_journal_to_trial_balance.rst b/docs/source/workbook/ch02_journal_to_trial_balance.rst index 967181f..a6c3b79 100644 --- a/docs/source/workbook/ch02_journal_to_trial_balance.rst +++ b/docs/source/workbook/ch02_journal_to_trial_balance.rst @@ -1,3 +1,6 @@ +Ch02 — Journal to trial balance +================================= + What you'll learn ----------------- - Write balanced journal entries in ``transactions.csv`` diff --git a/docs/source/workbook/ch03_adjusting_entries.rst b/docs/source/workbook/ch03_adjusting_entries.rst index c0a8c22..a44cdc7 100644 --- a/docs/source/workbook/ch03_adjusting_entries.rst +++ b/docs/source/workbook/ch03_adjusting_entries.rst @@ -1,3 +1,6 @@ +Ch03 — Adjusting entries +========================== + What you'll learn ----------------- - Explain why adjustments exist (accrual vs. cash) diff --git a/docs/source/workbook/ch04_closing_and_post_close.rst b/docs/source/workbook/ch04_closing_and_post_close.rst index 853c6ff..445409d 100644 --- a/docs/source/workbook/ch04_closing_and_post_close.rst +++ b/docs/source/workbook/ch04_closing_and_post_close.rst @@ -1,3 +1,6 @@ +Ch04 — Closing + post-close trial balance +=========================================== + What you'll learn ----------------- - Explain what “closing” means and why we do it