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