Skip to content

Comments

docs: comprehensive ebook improvements#65

Merged
jxnl merged 1 commit intomainfrom
docs/ebook-improvements
Jan 17, 2026
Merged

docs: comprehensive ebook improvements#65
jxnl merged 1 commit intomainfrom
docs/ebook-improvements

Conversation

@jxnl
Copy link
Owner

@jxnl jxnl commented Jan 17, 2026

Summary

This PR makes comprehensive improvements to the ebook (workshops section) based on the quality review. The changes focus on improving navigation, adding reference materials, and enhancing content consistency.

New Reference Materials

  • Glossary (glossary.md) - 30+ key term definitions with cross-references to chapters
  • Quick Reference (quick-reference.md) - Formulas, decision trees, and checklists for quick lookup
  • How to Use This Book (how-to-use.md) - Reading paths, prerequisites, and time estimates
  • Exercises (exercises.md) - 15+ hands-on exercises with step-by-step instructions

Structural Improvements

  • Added Chapter 7 to Introduction roadmap (was orphaned from navigation)
  • Standardized frontmatter across all chapters (fixed author: vs authors: inconsistency)
  • Expanded multi-part chapter references in Introduction (chapters 3-6 now list sub-chapters)
  • Added navigation footers to chapters with Previous/Next links
  • Updated mkdocs.yml with new Reference section

Content Enhancements

  • Added case study summary tables to chapters 0, 1, and 7
  • Linked workshop chapters to WildChat case study (Parts 1-3)
  • Added "Chapter at a Glance" boxes to key chapters (1, 3.1, 6.1)
  • Fixed code block formatting issues in chapters 2 and 3.1
  • Added exercises links from chapters to exercises page

Test plan

  • Verify mkdocs build completes without errors
  • Check new pages render correctly (glossary, quick-reference, how-to-use, exercises)
  • Verify navigation links work between chapters
  • Confirm case study links resolve correctly
  • Review chapter summary boxes display properly

Add reference materials and improve navigation:
- Create glossary.md with 30+ key term definitions
- Create quick-reference.md with formulas and decision trees
- Create how-to-use.md with reading paths and time estimates
- Create exercises.md with 15+ hands-on exercises

Improve structure and consistency:
- Add Chapter 7 to Introduction roadmap (was orphaned)
- Standardize frontmatter (authors array) in chapters 3.1, 3.2
- Expand multi-part chapter references in Introduction
- Add navigation footers to chapters
- Update mkdocs.yml with new reference section

Enhance content:
- Add case study summary tables to chapters 0, 1, 7
- Link workshop chapters to WildChat case study
- Add "Chapter at a Glance" boxes to key chapters
- Fix code block formatting issues
- Add exercises links from chapters
@gitnotebooks
Copy link

gitnotebooks bot commented Jan 17, 2026

@jxnl jxnl merged commit c10db70 into main Jan 17, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant