| Commit | Line | Data |
|---|
| eda0fb99 |
1 | =pod |
| 2 | |
| 3 | =head1 NAME |
| 4 | |
| 5 | Moose::Manual::Support - Policies regarding support, releases, and |
| 6 | compatibility. |
| 7 | |
| 8 | =head1 RELEASE SCHEDULE |
| 9 | |
| 10 | Moose uses the release early, release often philosophy. Moose is not |
| 11 | released on a schedule. Releases happen as new features and bug fixes |
| 12 | are required. |
| 13 | |
| 37c7d2c4 |
14 | Moose has historically been released fairly often, and most releases include |
| 15 | just a few features or bug fixes. |
| eda0fb99 |
16 | |
| 17 | =head1 DEPRECATION POLICY |
| 18 | |
| 19 | Moose has always prioritized correctness over performance and backwards |
| 79dce67a |
20 | compatibility. |
| eda0fb99 |
21 | |
| ccc47a38 |
22 | Major deprecations or API changes are first documented in the Changes |
| 204f629c |
23 | file as well as in L<Moose::Manual::Delta>. |
| eda0fb99 |
24 | |
| ccc47a38 |
25 | Moose then attempts to warn for deprecated features and API changes for |
| 26 | a reasonable number of releases before breaking any tested API. |
| eda0fb99 |
27 | |
| 28 | Moose will also warn during installation if the version being installed |
| 29 | will break a known installed dependency. Unfortunately due to the nature |
| 30 | of the Perl install process these warnings may be easy to miss. |
| 31 | |
| 32 | =head1 BACKWARDS COMPATIBILITY |
| 33 | |
| 34 | We try to ensure compatibility by having a extensive test suite (last |
| 35 | count just over around 5123 tests), as well as testing a number of |
| ccc47a38 |
36 | packages (currently just under 100 packages) that depend on Moose before |
| eda0fb99 |
37 | any release. |
| 38 | |
| 39 | The current list of downstream dependencies that are tested is in |
| 40 | C<xt/author/test-my-dependents.t>. |
| 41 | |
| 42 | =head1 VERSION NUMBERS |
| 43 | |
| 44 | Moose's version numbers are monotonically incrementing two decimal |
| 45 | values. The version numbers in Moose are I<not> semantic. This means |
| 46 | that version 1.00 will be the hundredth release, nothing more. |
| 47 | |
| 3d5e4dc0 |
48 | Occasionally, we will release a test release with a version like |
| 49 | 0.90_03. These versions may be less stable than non-test releases, and exist |
| 50 | so that developers can test potentially code-breaking changes. By default, the |
| 51 | CPAN client will not install a distribution which has an underscore in its |
| 52 | version. |
| 53 | |
| eda0fb99 |
54 | Moose was declared production ready at version 0.18 (via L<< |
| 55 | http://www.perlmonks.org/?node_id=608144 >>). |
| 56 | |
| 57 | =head1 CONTRIBUTING |
| 58 | |
| 59 | Moose has an open contribution policy. Anybody is welcome to submit a |
| 204f629c |
60 | patch. Please see L<Moose::Manual::Contributing> for more details. |
| eda0fb99 |
61 | |
| 79dce67a |
62 | =cut |
projects / gitmo/Moose.git / blame