docs/deprecations/how_to_deprecate.pod - How to Deprecate Parrot Code

How to Deprecate Parrot Code

So you've found a crufty bit of code in Parrot that's just screaming to be removed. Welcome to the club. There's a lot of them. This page documents the proper procedure to go through to get that junk code out of Parrot while causing minimal pain to Parrot's users (i.e. people who develop HLLs or libraries on top of Parrot).

Step 1: Give Notice

Step 2: Wait

Step 3: Patch

Step 4: Document

Step 5: Apply