Skip to content

docs(readme): trim to half length; surface 1.3.0 RCL + 2.0.0 wire removal - #175

Merged
youtalk merged 2 commits into
mainfrom
docs/readme-shorten
Jul 13, 2026
Merged

docs(readme): trim to half length; surface 1.3.0 RCL + 2.0.0 wire removal#175
youtalk merged 2 commits into
mainfrom
docs/readme-shorten

Conversation

@youtalk

@youtalk youtalk commented Jul 13, 2026

Copy link
Copy Markdown
Owner

What

Shortens README.md from 459 → 250 lines (~45% cut) and makes the release story explicit, as it had drifted behind the code.

Why

The README was too long, and its release framing stopped at 1.2.0 — it never surfaced that 1.3.0 lands the native RCL backend or that the pure-Swift wire path is deprecated and removed in 2.0.0.

Changes

  • New "Backends" section near the top consolidates the old API stability + Deprecation notes into one place:
    • 1.3.0 native RCL backend — Apple default-on (per-variant CRos2Jazzy / CRos2JazzyZenoh xcframeworks) and Linux (system ROS 2).
    • Direct ZenohClient() / DDSClient() construction is deprecated → removed in 2.0.0; the umbrella API is unchanged and not deprecated.
    • Per-variant nuance (Apple zenoh-rmw symbol collision, Windows/Android RCL status) kept.
  • Release history — added a bold 1.3.0 row at the top; collapsed each older row to a one-line headline (dropped fine-grained patch rows).
  • Platforms — folded the OS-coverage market-share table into a single sentence.
  • Quick Start — merged publish / DDS / subscribe into one block; collapsed Parameters / Actions / examples into a pointer paragraph.
  • Compressed Features, Installation asides, Code generation, and the Roadmap.

No documentation links were removed; all relative links verified to resolve.

youtalk added 2 commits July 13, 2026 08:49
…oval

The README had grown to 459 lines. Cut it to ~250 while making the
release story explicit:

- New 'Backends' section near the top consolidates the API-stability and
  deprecation notes: 1.3.0 lands the native RCL backend (Apple default-on,
  Linux via system ROS 2), and direct ZenohClient()/DDSClient() construction
  is deprecated and removed in 2.0.0. The umbrella API is unchanged.
- Add a 1.3.0 row (bold) at the top of the release-history table.
- Fold the OS-coverage market-share table into one sentence under Platforms.
- Merge the publish/DDS/subscribe snippets into one Quick Start block;
  collapse Parameters/Actions/examples into a pointer paragraph.
- Compress Features, Installation asides, Code generation, and the Roadmap.

No content links removed; all relative links verified to resolve.

Signed-off-by: Yutaka Kondo <yutaka.kondo@youtalk.jp>
Signed-off-by: Yutaka Kondo <yutaka.kondo@youtalk.jp>
@youtalk
youtalk enabled auto-merge (squash) July 13, 2026 16:16
@youtalk
youtalk merged commit 2d68d36 into main Jul 13, 2026
19 checks passed
@youtalk
youtalk deleted the docs/readme-shorten branch July 13, 2026 16:24
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