lib/Moose/Manual/Support.pod

   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
  20 compatibility.
  21
  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>
  24
  25 Moose then attempts to warn for deprecated features and API changes for
  26 a reasonable number of releases before breaking any tested API.
  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
  36 packages (currently just under 100 packages) that depend on Moose before
  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
  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
  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
  64 =cut