11 Apr 2021 19:09:54 UTC
- Distribution: Statocles
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (115)
- Testers (74 / 198 / 9)
- KwaliteeBus factor: 1
- % Coverage
- License: perl_5
- Perl: v5.16.0
- Download (484.85KB)
- MetaCPAN Explorer
- Subscribe to distribution
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- This version
- Latest version++ed by:10 non-PAUSE users
Statocles::Help::Policy - Development and deprecation policies
This document describes development and deprecation policies.
Major versions are the only time when APIs can break. Major versions must be at least 6 months apart.
Features will be deprecated for an entire major version before they are removed.
Deprecation will start in the current major version, but only in testing (when the
HARNESS_ACTIVEenvironment variable set by the Test::Harness module is true). All deprecations will be accompanied with the new feature when possible so users can switch immediately.
When the next major version happens, the deprecation will warn always. When the major version after that happens, the deprecation will be fatal. Finally, after the next major version, the warning/exception will be removed (and so, things will probably fail in unexpected ways).
So, for something deprecated in v1.28:
Warning only when testing from v1.28 to v2.00
Warning in normal operation from v2.00 to v3.00
Fatal exception from v3.00 to v4.00
Exception removed in v4.00
All deprecations will be recorded in the upgrading guide along with instructions on how to work through it.
Statocles::Help::Upgrading - Guide to fixing use of deprecated features
Doug Bell <email@example.com>
This software is copyright (c) 2016 by Doug Bell.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
|s||Focus search bar|
|?||Bring up this help dialog|
|g p||Go to pull requests|
|g i||go to github issues (only if github is preferred repository)|
|g a||Go to author|
|g c||Go to changes|
|g i||Go to issues|
|g d||Go to dist|
|g r||Go to repository/SCM|
|g s||Go to source|
|g b||Go to file browse|