Communicating the change

  • Package version number should difference:
    • Patch releases
    • Major releases
  • Function or argument should be explicit about their lifecycle stage:
    • Experimental
    • Stable
    • Superseded
    • Deprecated
  • Enact deprecation process in a phased way.