I agree such table is important, +1. Some clarifications: 1. We should include when the version was deprecated (i.e. we started emitting warnings) as well as when the replacement function has been available. Most times, the replacement function is available at least two releases before the deprecation. It is important to keep this perspective.
2. We should not include anything pre 1.0 because that would make the table unnecessarily large and it wouldn't be helpful for the huge majority of developers. By sticking to 1.0, hopefully the table is not hard to assemble, giving it is a matter of reading the changelogs and searching for "deprecate" in the code base. Finally, I would suggest for this table to be listed in a page called "Deprecations" (alongside the "Operators" page and others). We should likely move our deprecation policy there: https://github.com/elixir-lang/elixir/blob/master/RELEASE.md#deprecation-policy Thank you for looking into this! *José Valim* www.plataformatec.com.br Skype: jv.ptec Founder and Director of R&D On Wed, Feb 22, 2017 at 3:05 AM, eksperimental <[email protected]> wrote: > I would also like to propose to introduce a new page in the project that > lists all the deprecated > functions, what was the version it was deprecated, and if they have been > replaced/renamed by new function. > > It happed to me once that I was using a package that was written for > elixir 0.9.x, > this function was renamed in 1.0, and then deprecated or renamed again > (can't remember) > in a later minor version. So finding the current function was not as > straight-forward as I would > have wanted it. > > Ideally I would like it to include pre-1.0 elixir version. > I can volunteer myself to start with a mock-up and eventually start > filling up the table. > > Please let me know what you think > > -- > You received this message because you are subscribed to the Google Groups > "elixir-lang-core" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit https://groups.google.com/d/ > msgid/elixir-lang-core/20170222090523.767b36c1. > eksperimental%40autistici.org. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "elixir-lang-core" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/elixir-lang-core/CAGnRm4JCqFXUphDSnhnZdDrv9mfOXaOcHH3zbNwwmt-gjVPzpw%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
