Skip to content

docs: refresh README (prominent textbook links + education best practices)#29

Merged
jonfroehlich merged 1 commit into
masterfrom
docs/readme-refresh
Jun 26, 2026
Merged

docs: refresh README (prominent textbook links + education best practices)#29
jonfroehlich merged 1 commit into
masterfrom
docs/readme-refresh

Conversation

@jonfroehlich

Copy link
Copy Markdown
Member

Refreshes the README following open-source + education best practices. Targeted revision of the existing README (kept the good lesson table, dual setup paths, tests, and layout).

Changes

No content/notebook changes; docs only.

🤖 Generated with Claude Code

…t practices)

- Add a top callout + badge linking the Physical Computing textbook (home +
  signals module + source repo) so it's front-and-center.
- Add status badges: CI, Python 3.12, MIT license, textbook.
- New "Who this is for & how to use" section (students vs instructors).
- Add Contributing, Citing, and Acknowledgments sections.
- Fix stale text: notebooks now ship complete with `### Example solution`
  cells (issue #6); StepTracker is consolidated, so drop the old
  "*-WithExampleSolution as answer key" description.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@jonfroehlich jonfroehlich merged commit 175542d into master Jun 26, 2026
2 checks passed
@jonfroehlich jonfroehlich deleted the docs/readme-refresh branch June 26, 2026 16:42
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