docs

Author: pavel-kirienko

CHANGELOG.rst

@@ -6,7 +6,12 @@ Changelog v2
 v2.0
 ----
 
-Work in progress.
+**Work in progress.**
+
+This is a full rewrite from scratch that changes the API entirely, to the point that there are no commonalities with v1.
+The new version offers a significantly simplified API (the total surface is about one-tenth of the previous version)
+and supports Cyphal v1.1, which adds decentralized named topics, tunable reliability, and service discovery
+on top of Cyphal v1.0.
 
 Changelog v1
 ============

README.md

@@ -13,6 +13,8 @@ _pub/sub without steroids_
 
 -----
 
-Pure-Python implementation of the [Cyphal](https://opencyphal.org) stack that runs on GNU/Linux, Windows, and macOS.
-
+Python implementation of the [Cyphal](https://opencyphal.org) stack that runs on GNU/Linux, Windows, and macOS.
 See `examples/` for usage examples.
+
+**WORK IN PROGRESS**: The work on v2 is still ongoing and the new version is not yet ready for production use.
+Users seeking stability should continue using PyCyphal v1. The two versions are wire-compatible on Cyphal/CAN.