| oFono release FAQ |
| ***************** |
| |
| What is the release cycle? |
| ========================== |
| |
| There is no clear specified release cycle. The project follows the general |
| open source paradigm of release early and release often. Historically the |
| release cadence has been about two to three weeks. |
| |
| The two weeks release cycle is a general rule of thumb. It will never be |
| precise down to an exact day. The decision to release is driven by the |
| code flow and changes made during that cycle. When a closed set of features |
| has been merged, then a new release is considered. When a lot changes are |
| merged, then the release cycle can be decreased down to weekly releases. |
| And in case not many changes have been made and no new features are merged, |
| it can happen that the release cycle becomes as long as one month. |
| |
| In addition to the normal releases during a cycle, there could be also |
| so called brown-paper-bag type of releases. The releases are fixing |
| critical issues with the previous release. Normally they happen in case a |
| serious bug or regression slipped into the source and where it makes sense |
| to fix it right away. The goal is to keep this type of releases to a bare |
| minimum, but they do happen every now and then. From past releases they |
| are to be expected around three times per year. |
| |
| |
| What does the release number mean? |
| ================================== |
| |
| Every release contains a major and a minor version. The major version only |
| indicates an API version and it should not change until the D-Bus API is |
| backwards incompatible. The same major version can contain new version of |
| the API as long as it is backward compatible. This allows for extensions |
| of the D-Bus API within the same major version. |
| |
| The minor version number is just an increasing number and has itself no |
| special meaning. The minor version will increase until a new backwards |
| incompatible API is required and a new major number is used. |
| |
| There is no stable API guarantee for the internal plugin API. The release |
| numbers are not covering this. |