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/CAPdFhdXBW7R2JsZdY9i3o4QV2mg7Biuh8kQapAOJniGuQxHEYg%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
