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 | |
14 | There have been to date, 98 releases of Moose over just under four |
15 | years. This is an average of a release every two weeks. |
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 |
23 | file as well as in L<Moose::Manual::Delta|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 |
60 | patch. Please see |
61 | L<Moose::Manual::Contributing|Moose::Manual::Contributing> for more |
62 | details. |
63 | |
79dce67a |
64 | =cut |