REL: v2.0.0rc2

Author: danielballan

docs/source/reference/changelog.rst

@@ -7,6 +7,7 @@ A catalog of new features, improvements, and bug-fixes in each release. Follow
 links to the relevant GitHub issue or pull request for specific code changes
 and any related discussion.
 
+.. include:: changelog/v2.0.0.txt
 .. include:: changelog/v1.2.5.txt
 .. include:: changelog/v1.2.4.txt
 .. include:: changelog/v1.2.3.txt

docs/source/reference/changelog/v1.0.0.txt

@@ -3,8 +3,7 @@
 v1.0.0 (2020-03-13)
 -------------------
 
-This release amounts to a full rewrite of databroker. See
-:ref:`v2-transition` for details.
+This release amounts to a full rewrite of databroker.
 
 See the
 `v1.0.0 GitHub milestone <https://github.com/bluesky/databroker/milestone/11?closed=1>`_

docs/source/reference/changelog/v2.0.0.rst

@@ -0,0 +1,24 @@
+v2.0.0 (2025-11-20)
+-------------------
+
+This release remakes Databroker into a wrapper around `Tiled`_, designed to
+provide a backward-compatible shim to facilitate a transition to using `Tiled`_
+directly.
+
+Databroker is no longer recommended for new users or facilities adopting
+Bluesky. Instead, `Tiled`_ with `Bluesky Tiled Plugins`_ is recommended as the
+canonical way to persist and access data and metadata from Bluesky.
+
+Databroker now serves two purposes that remain relevant for some users and some
+faciilities. First, it contains code adapting the legacy MongoDB-based Bluesky
+document storage to Tiled---effectively a server-side plugin for Tiled. Second,
+it wraps the Tiled Python client to provide an API backward-compatible with
+legacy Databroker user code. _If you do not have MongoDB-based Bluesky storage
+and you do not have legacy Databroker user code, you do not need Databroker._
+
+Databroker will be maintained by NSLS-II through **April 2027** at minimum to
+support the transition from MongoDB-based document storage to PostgreSQL-based
+storage. The Python user interface may be maintained longer still, depending on
+the need.
+
+.. _Tiled: https://blueskyproject.io/tiled/