Skip to content

docs: rewrite README with English on top, expanded usage, and badges - #1

Merged
RyodoTanaka merged 1 commit into
masterfrom
docs/readme-rewrite
Sep 23, 2026
Merged

RyodoTanaka merged 1 commit into
masterfrom
docs/readme-rewrite

Conversation

@RyodoTanaka

Copy link
Copy Markdown
Member

What

  • Moved English to the top of the README, kept the original Japanese content in full below it (translated/updated to match — nothing dropped).
  • Removed the pip/PyPI and apt/bloom publishing walkthroughs from the README (not useful to someone just using the package) — moved to .docs/PUBLISHING.md for maintainers instead, see chore: make setup.cfg comments bilingual, resolve stale TODOs #2.
  • Expanded the usage section: full colcon lbuild/lb option reference (--event-handlers, --continue-on-error, --parallel-workers/-j/--jobs), colcon lclean/lc options, how to try the bundled demo workspace, using the live_status event handler without the verbs, locale detection for this package's own help text, and non-TTY behavior.
  • Added CI / PyPI version / Python versions / license badges at the top.

Why

Requested: English-first README for a wider audience, more detail on day-to-day colcon-live-tools usage, and a more presentable landing page (badges) for visitors.

🤖 Generated with Claude Code

- English section moved to the top, original Japanese content kept
  below it in full (translated/updated to match, nothing removed).
- Removed the pip/PyPI and apt/bloom publishing walkthroughs from the
  README -- not useful to someone just using the package; moved to
  .docs/PUBLISHING.md for maintainers instead (see that PR).
- Expanded the usage section: full colcon lbuild/lb option reference
  (--event-handlers, --continue-on-error, --parallel-workers/-j/--jobs),
  colcon lclean/lc options, how to try the bundled demo workspace, how
  to use the live_status event handler without the verbs, locale
  detection for this package's own help text, and non-TTY behavior.
- Added CI / PyPI version / Python versions / license badges at the top.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@RyodoTanaka
RyodoTanaka merged commit 669d4bf into master Sep 23, 2026
6 checks passed
@RyodoTanaka
RyodoTanaka deleted the docs/readme-rewrite branch September 23, 2026 15:07
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