From e541147a9ba11b0e6f40941a4e31cab16a9785c9 Mon Sep 17 00:00:00 2001 From: Andre Klapper Date: Wed, 25 Feb 2026 11:22:17 +0100 Subject: [PATCH] Diviner: Update "Managing Conduit Changes" Summary: List all method statuses; link to Changelog for convenience. Test Plan: Run `./bin/diviner generate`; look at http://phorge.localhost/book/phorge/article/conduit_changes/ Reviewers: O1 Blessed Committers, avivey Reviewed By: O1 Blessed Committers, avivey Subscribers: tobiaswiese, valerio.bozzolan, Matthew, Cigaryno Differential Revision: https://we.phorge.it/D26800 --- src/docs/user/field/conduit_changes.diviner | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/src/docs/user/field/conduit_changes.diviner b/src/docs/user/field/conduit_changes.diviner index b2246310e3..f79127c259 100644 --- a/src/docs/user/field/conduit_changes.diviner +++ b/src/docs/user/field/conduit_changes.diviner @@ -17,15 +17,16 @@ transitioning between API versions. Method Statuses =============== -Methods have one of three statuses: +Methods have one of these statuses: - **Unstable**: This is a new or experimental method which is subject to change. You may call these methods to get access to recently released features, but should expect that you may need to adjust your usage of them before they stabilize. - **Stable**: This is an established method which generally will not change. - - **Deprecated**: This method will be removed in a future version of - Phorge and callers should cease using it. + - **Frozen**: This method will eventually get deprecated. + - **Deprecated**: This method has been superseded by a new method and will + be removed in a future version of Phorge. Callers should cease using it. Normally, a method is deprecated only when it is obsolete or a new, more powerful method is available to replace it. @@ -45,10 +46,10 @@ outdated APIs. The most common cause of calls to deprecated methods is users running very old versions of Arcanist. They can normally upgrade by running `arc upgrade`. -When the changelogs mention a method deprecation, you can use the call logs -to identify callers and notify them to upgrade or switch away. When the -changelogs mention a method removal, you can use the call logs to verify that -you will not be impacted. +When the [changelogs](https://we.phorge.it/w/changelog/) mention a method +deprecation, you can use the call logs to identify callers and notify them to +upgrade or switch away. When the changelogs mention a method removal, you can +use the call logs to verify that you will not be impacted. Next Steps -- 2.51.2