Subtle difference, but correct! Thanks a lot. On Wed, 22 Feb 2017 15:17:16 -0800 Jon Parise <[email protected]> wrote:
> A very minor piece of feedback, but I think "Deprecated In" reads slightly > better than "Deprecated By" when the column's value is the version that > introduced the deprecation. > > On Wed, Feb 22, 2017 at 2:58 PM, eksperimental <[email protected]> > wrote: > > > First draft > > https://github.com/eksperimental/elixir/blob/deprecations/ > > lib/elixir/pages/Deprecations.md > > > > PR is here > > https://github.com/elixir-lang/elixir/pull/5808 > > > > Please everyone let me know what you think or how it could be improved, > > thank you. > > > > On Wed, 22 Feb 2017 20:24:20 +0700 > > eksperimental <[email protected]> wrote: > > > > > You are welcome José. > > > I agree on all the points. > > > I will work on a draft and submit it as Work-in-progress Pull Request. > > > > > > Cheers, > > > > > > On Wed, 22 Feb 2017 11:54:32 +0100 > > > José Valim <[email protected]> wrote: > > > > > > > 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/ms > > gid/elixir-lang-core/20170223055855.78b58930.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/20170223062242.4fb6ccff.eksperimental%40autistici.org. For more options, visit https://groups.google.com/d/optout.
