Skip to content

v1.9 — OSS hygiene + Performance

Choose a tag to compare

@dripips dripips released this 12 May 21:12

v1.9 — OSS hygiene + Performance instrumentation

📚 OSS hygiene

Three files every serious open-source project needs:

  • CHANGELOG.md — compiled history of v1.0–v1.8 in Keep-a-Changelog format. Sections per release: Added / Fixed / Migration / Security / i18n.
  • ROADMAP.md — done milestones, v1.9–v1.12 planned items, v2.0 multi-tenant + Docker deploy story (per request: Docker container + scripts/install.sh rewrite + scripts/update.sh for zero-downtime upgrades + docker-compose.prod.yml + hosted demo).
  • CONTRIBUTING.md — local setup, conventions, test/lint commands, i18n parity workflow, screenshot regen, PR flow, "good first issue" suggestions.

⚡ Performance instrumentation

  • bullet (dev + test groups) — N+1 detector. Enabled in dev with rails footer panel + log warnings. Test-mode raise is deferred to v1.11 (need baseline audit first — current full-seed smoke would fail).
  • rack-mini-profiler (dev only) — speed badge in page corner. /?pp=help for options.
  • config/initializers/bullet.rb — guarded with return unless defined? so prod without the gem still boots.

Next: v1.10 will use bullet output to fix N+1 baseline, add fragment caching to hot dashboard widgets, and push RSpec coverage to >80%.