Changes between Version 3 and Version 4 of HowToDeprecate

Show
Ignore:
Timestamp:
06/29/10 16:43:50 (4 years ago)
Author:
cotto
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • HowToDeprecate

    v3 v4  
    1010=== Step 2: Wait === 
    1111 
    12  * don't nuke anything until after the next supported release has been cut 
     12 * pick an eligible release for the deprecation policy 
     13 * backwards-incompatible changes can't happen until a stable release has gone out the door with a notification of the coming deprecation 
     14 * see [browser:trunk/docs/project/support_policy.pod docs/project/support_policy.pod] for more information 
    1315 
    1416=== Step 3: Patch === 
    1517 
    1618 * write the code, possibly in a branch 
    17  * if possible, maintain backwards-compatibility to ease the migration 
    18  * test your changes with HLLs and libraries such as partcl-nqp, Rakudo, winxed, Kakapo, etc 
     19 * unless it's highly impractical, maintain backwards-compatibility to ease the migration 
     20   - this also means you can commit your changes immediately and remove the deprecated interface later 
     21 * test your changes with current HLLs and libraries such as partcl-nqp, Rakudo, winxed, Kakapo, etc 
    1922 
    2023=== Step 4: Document === 
     
    2225 * add a summary of your change to ParrotDeprecations 
    2326 * add a complete description to the appropriate version transition deprecations page (e.g. [wiki:ParrotDeprecationsFor2.6 ParrotDeprecationsFor2.6]) 
    24  * walk through the the documentation to ensure that it's complete enough for a user to use to upgrade code 
     27 * walk through the the documentation to ensure that it's sufficient for a user to use to upgrade his or her code 
    2528 
    2629=== Step 5: Apply === 
    2730  
    28  * merge or commit your changes to trunk 
     31 * make sure the HLLs and libraries are ready the deprecation (and submit patches if not) 
     32 * merge or commit your backwards-incompatible changes to trunk 
    2933 * close the deprecation ticket 
    3034 * bump PBC_COMPAT and run mk_native_pbc if needed