jkcfg / jk

Configuration as Code with ECMAScript
https://jkcfg.github.io
Apache License 2.0
406 stars 30 forks source link

Define mechanism to deprecate and remove std lib functions (before we reach 1.0.0) #163

Open dlespiau opened 5 years ago

dlespiau commented 5 years ago

We have no stdlib API guarantees until we reach 1.0.0 but it would still be nice to leave users the opportunity to fix their code for a whole cycle before removing the API entry point. Even better, we could tell them how to fix things.

Proposal:

It may not always be technically possible to do the above, but we can try.

dlespiau commented 5 years ago

Deprecations are now documented at least: https://github.com/jkcfg/jk/blob/master/docs/deprecations.md