recaptime.dev
@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
+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