Skip to content

docs(readme): rewrite with full reference, examples and badges#10

Merged
guillaumedelre merged 1 commit into
developfrom
feat/update-readme
May 14, 2026
Merged

docs(readme): rewrite with full reference, examples and badges#10
guillaumedelre merged 1 commit into
developfrom
feat/update-readme

Conversation

@guillaumedelre
Copy link
Copy Markdown
Owner

Summary

Complete README rewrite — the previous version was outdated (referenced deleted sensor-api.py, Python 2 commands, hardcoded IP in cron).

Now covers:

  • CI badge
  • Hardware wiring diagram (GPIO pinout)
  • Architecture diagram (ASCII)
  • Installation steps with raspi-config I²C setup
  • Full configuration table (all env vars with defaults)
  • Usage: CLI, HTTP API, Docker (run + test), cron
  • Complete API reference: all endpoints with request/response examples including error codes (503, 502)
  • Home Assistant integration: MQTT sensor config + automation example
  • Development: test suite setup, full pytest output, Docker test run
  • Project structure with dependency table
  • Sensor specifications table

Test plan

  • README renders correctly on GitHub (badges, ASCII diagrams, code blocks)
  • All links are valid (CI badge, datasheet link)
  • No references to old sensor-api.py

Complete rewrite covering: hardware wiring, architecture diagram,
installation, all env vars, CLI/API/Docker usage with examples,
full API reference with request/response samples, Home Assistant
MQTT integration, development setup, test output, project structure
and sensor specifications table. Add CI badge.

Co-authored-by: agilicode <agilicode@gmail.com>
@guillaumedelre guillaumedelre merged commit ea9eeb0 into develop May 14, 2026
2 checks passed
@guillaumedelre guillaumedelre deleted the feat/update-readme branch May 14, 2026 09:16
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