@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.) hq.recaptime.dev/wiki/Phorge
phorge phabricator

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

+8 -7
+8 -7
src/docs/user/field/conduit_changes.diviner
··· 17 17 Method Statuses 18 18 =============== 19 19 20 - Methods have one of three statuses: 20 + Methods have one of these statuses: 21 21 22 22 - **Unstable**: This is a new or experimental method which is subject to 23 23 change. You may call these methods to get access to recently released 24 24 features, but should expect that you may need to adjust your usage of 25 25 them before they stabilize. 26 26 - **Stable**: This is an established method which generally will not change. 27 - - **Deprecated**: This method will be removed in a future version of 28 - Phorge and callers should cease using it. 27 + - **Frozen**: This method will eventually get deprecated. 28 + - **Deprecated**: This method has been superseded by a new method and will 29 + be removed in a future version of Phorge. Callers should cease using it. 29 30 30 31 Normally, a method is deprecated only when it is obsolete or a new, more 31 32 powerful method is available to replace it. ··· 45 46 The most common cause of calls to deprecated methods is users running very 46 47 old versions of Arcanist. They can normally upgrade by running `arc upgrade`. 47 48 48 - When the changelogs mention a method deprecation, you can use the call logs 49 - to identify callers and notify them to upgrade or switch away. When the 50 - changelogs mention a method removal, you can use the call logs to verify that 51 - you will not be impacted. 49 + When the [changelogs](https://we.phorge.it/w/changelog/) mention a method 50 + deprecation, you can use the call logs to identify callers and notify them to 51 + upgrade or switch away. When the changelogs mention a method removal, you can 52 + use the call logs to verify that you will not be impacted. 52 53 53 54 54 55 Next Steps