API status: Difference between revisions
m (moved Feature stability levels to API status: Better naming.) |
|||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<div class="title"> | <div class="title">API Status</div> | ||
At Open-Xchange we are continuously improving our products. Most of the time the | At Open-Xchange we are continuously improving our products. Most of the time the | ||
changes we make will have no side effects on existing installations and 3rd | changes we make will have no side effects on existing installations and 3rd | ||
| Line 16: | Line 16: | ||
API features can be categorized as follows. | API features can be categorized as follows. | ||
== In | == In Development == | ||
{{Stability-experimental}} | |||
This feature is currently being developed by Open-Xchange. If this is a customer | This feature is currently being developed by Open-Xchange. If this is a customer | ||
| Line 30: | Line 31: | ||
== New == | == New == | ||
{{Stability-unstable}} | |||
This feature was recently released, is fully tested and considered stable but is | This feature was recently released, is fully tested and considered stable but is in the process of settling. Based on customer experience across a diverse range | ||
in the process of settling. Based on customer experience across a diverse range | |||
of production environments it is possible that further changes may be necessary. | of production environments it is possible that further changes may be necessary. | ||
To indicate this we have defined a separate level from Stable. | To indicate this we have defined a separate level from Stable. | ||
| Line 40: | Line 41: | ||
== Stable == | == Stable == | ||
{{Stability-stable}} | |||
The feature is considered stable and is fully documented. However it is possible | The feature is considered stable and is fully documented. However it is possible | ||
| Line 49: | Line 51: | ||
== Frozen == | == Frozen == | ||
{{Stability-frozen}} | |||
This API has been tested extensively in production and is unlikely to be | This API has been tested extensively in production and is unlikely to be | ||
| Line 55: | Line 58: | ||
== Deprecated == | == Deprecated == | ||
{{Stability-deprecated}} | |||
This feature is known to be problematic, and changes or even removal are | This feature is known to be problematic, and changes or even removal are | ||
Latest revision as of 14:04, 7 August 2013
At Open-Xchange we are continuously improving our products. Most of the time the changes we make will have no side effects on existing installations and 3rd party software integration. However, sometimes fixing a bug or adding a new feature requires changes to the existing API that are not always backwards compatible.
To help you understand the impact of these changes we have defined the following API status list. This page describes each level and indicates how information about changes to documented features is communicated.
In creating these levels we were inspired by the node.js stability index.
API features can be categorized as follows.
In Development
API status: In Development
This feature is currently being developed by Open-Xchange. If this is a customer request the customer requesting the change will provide feedback. On occasion Open-Xchange may solicit input from a wider audience in order to optimize feature development for the widest possible audience. Due to the low overhead of making changes at this stage feedback is more likely to be integrated into the feature than at other status levels.
Changes will not be announced. Using the watch function to stay updated may help. We will try to update the documentation concurrently with code changes, but this cannot be guaranteed.
New
API status: New
This feature was recently released, is fully tested and considered stable but is in the process of settling. Based on customer experience across a diverse range of production environments it is possible that further changes may be necessary. To indicate this we have defined a separate level from Stable.
This feature is documented. Changes will not be announced. We recommend using the watch function for the given page to stay updated.
Stable
API status: Stable
The feature is considered stable and is fully documented. However it is possible that cleanup in the underlying code may cause minor changes. Backwards-compatibility will be maintained if possible.
Changes that are not backwards compatible will be announced in the release notes.
Frozen
API status: Frozen
This API has been tested extensively in production and is unlikely to be changed. If changes do occur they will be announced in the release notes two major releases in advance.
Deprecated
API status: Deprecated
This feature is known to be problematic, and changes or even removal are planned. Do not rely on it. Use of the feature may cause warnings. Backwards compatibility should not be expected.
Changes will not be announced.