Page MenuHomePhabricator

Mark "v3" API methods as stable; mark obsoleted methods as "Frozen"
ClosedPublic

Authored by epriestley on Jan 8 2017, 8:57 PM.

Details

Summary

Ref T12074. The "v3" API methods (*.search, *.edit) are currently marked as "unstable", but they're pretty stable and essentially all new code should be using them.

Although these methods are seeing some changes, almost all changes are additive (support for new constraints or attachemnts) and do not break backward compatibility. We have no major, compatibility-breaking changes planned.

I don't want to mark the older methods "deprecated" yet since arc still uses a lot of them and there are some capabilities not yet available on the v3 methods, but introduce a new "frozen" status with pointers to the new methods.

Overall, this should gently push users toward the newer methods.

Test Plan

Screen Shot 2017-01-08 at 12.54.18 PM.png (533×2 px, 84 KB)

Diff Detail

Repository
rP Phabricator
Lint
Lint Not Applicable
Unit
Tests Not Applicable