Home of the Mozilla Identity team
Later this month, we will be announcing the first “beta” release of Persona. Part of that announcement will include committing to long-term support for our APIs, so that developers can more confidently rely on Persona in their sites and applications. This post will serve to outline the deprecation strategy that Persona will adopt for its beta releases.
Before deprecating or making backwards incompatible changes to stable APIs, the Persona team will announce the change on the Persona-notices mailing list. The team will also add deprecation warnings to the relevant code and documentation.
The notice will be posted at least six months prior to the change taking effect. After posting the notice, the team will listen for feedback and monitor the ongoing use of the API. Depending on these metrics, the deadline may be extended once by an additional six months. Any extension will be communicated via the Persona-notices mailing list.
Yes. If a security vulnerability necessitates a backwards incompatible change to a stable API, then that change may be expedited and a message will be sent to Persona-notices.
Backwards compatible and cosmetic changes may also be expedited.
Beta 1 will only stabilize the subset of Persona APIs that are necessary for authenticating users. Subsequent beta releases will eventually extend this commitment to the remaining APIs, Persona’s data formats, and the cross-browser shim.
Specifically, the first beta release will only commit to:
APIs that are undocumented or already marked as deprecated may be removed more rapidly. This includes:
If you are using any of these undocumented or deprecated APIs, please update your code. As per usual, backwards incompatible deprecations will be announced on the Persona-notices mailing list in advance.
While the APIs are fully documented on MDN, the Persona team is committed to supporting developers that rely on Persona.
Lastly, if your site depends on Persona, or you are supporting people who do, please subscribe to the Persona-notices mailing list.