Well, it is definitely a debate because, although the mechanism is available we still need to debate:
1. if we will add the tags to Elixir 2. and then if we will include those categories in Elixir's own docs Keep in mind the current categories implementation completely segregate functions in the sidebar, messing up the alphabetical ordering. And every time we messed up with the alphabetical ordering, people got really upset, as it made looking for a particular function (or something that you know exists but you are not quite sure about the name) much harder. So my initial response is that we won't add more categories to Elixir itself unless we find another way to show them that doesn't mess with the alphabetical ordering in the documentation sidebar. Otherwise it will be just a matter of time before people ask us to remove the categories. *José Valim* www.plataformatec.com.br Skype: jv.ptec Founder and Director of R&D On Fri, Sep 14, 2018 at 7:01 PM, Alexander Marks-Katz < english3000....@gmail.com> wrote: > Also, this isn't a debate. The mechanism has already been implemented: > https://github.com/elixir-lang/ex_doc/issues/876 > > English3000.org: *A data-driven approach to language learning.* > > > On Fri, Sep 14, 2018 at 9:52 AM Alexander Marks-Katz < > english3000....@gmail.com> wrote: > >> No. Data structure-based modules *already* exist. I'm referring to >> `Conversions`, `Data`, `Operations`, etc. as tags. >> >> To help you understand, I'm talking about differences between functions >> like how words have different parts of speech. I'm not talking about the >> difference between numbers and words. >> >> Across all data structure modules, there are functions that specifically >> exist to *convert* that data structure to another. Making that distinct >> from other grouping/categories will make the documentation >> *significantly* more reasonable and allow newcomers to notice useful >> functions by grouping that they don't with an alphabetized list. >> >> Point being, you wouldn't put a function for integers in the `String` >> module, so why would you put functions that convert data, operate on it, >> and give metadata on it all mixed together--as opposed to grouping them >> within the module. >> >> English3000.org: *A data-driven approach to language learning.* >> >> >> On Fri, Sep 14, 2018 at 1:38 AM Sven Gehring <cbr...@gmail.com> wrote: >> >>> I don't think forum discussions and function documentation can >>> necessarily be compared. >>> >>> If I understand the contents of the example repo right, you'd want to >>> tag functions by the type of their arguments (e.g. which data structures >>> they operate on). >>> This is largely already sorted by how they are organized in modules >>> (Enum, String, etc.) I would go as far as saying those modules ARE >>> categories of functions. >>> >>> Adding an additional way of sorting the documentation would be more >>> confusing than helpful in my opinion. >>> Personally, I also never had any issues finding functions, even when I >>> started learning Elixir >>> >>> On Fri, 14 Sep 2018 at 04:47 <english3000....@gmail.com> wrote: >>> >>>> Just as we can tag discussions on Elixir Forum, making them more >>>> searchable, Elixir core's functions should be tagged. >>>> >>>> This will make the Hex docs *significantly* more beginner-friendly and >>>> will give the core team a more systematic way to track the size and scope >>>> of the kernel. >>>> >>>> `@doc` could accept a `:category` tag (I've made a repo >>>> <https://github.com/English3000/elixir_vocab> *[in progress]* >>>> categorizing the more commonly used functions from the basic data structure >>>> modules). >>>> >>>> To make tags even more powerful, you can add an `:equivalents` (or >>>> `:delegates`) tag which would accept a list of functions that do the same >>>> thing or something very similar. >>>> >>>> -- >>>> 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 elixir-lang-core+unsubscr...@googlegroups.com. >>>> To view this discussion on the web visit https://groups.google.com/d/ms >>>> gid/elixir-lang-core/d370cbf9-92d0-4814-8332-54189634842e% >>>> 40googlegroups.com >>>> <https://groups.google.com/d/msgid/elixir-lang-core/d370cbf9-92d0-4814-8332-54189634842e%40googlegroups.com?utm_medium=email&utm_source=footer> >>>> . >>>> For more options, visit https://groups.google.com/d/optout. >>>> >>> -- >>> You received this message because you are subscribed to a topic in the >>> Google Groups "elixir-lang-core" group. >>> To unsubscribe from this topic, visit https://groups.google.com/d/to >>> pic/elixir-lang-core/TxDvKFwltZU/unsubscribe. >>> To unsubscribe from this group and all its topics, send an email to >>> elixir-lang-core+unsubscr...@googlegroups.com. >>> To view this discussion on the web visit https://groups.google.com/d/ms >>> gid/elixir-lang-core/CAFuVuxwMu3wh%3DC%2B2Lo2emziY%3DMZAucxX >>> qUCrsMdTLrL3bL4bRQ%40mail.gmail.com >>> <https://groups.google.com/d/msgid/elixir-lang-core/CAFuVuxwMu3wh%3DC%2B2Lo2emziY%3DMZAucxXqUCrsMdTLrL3bL4bRQ%40mail.gmail.com?utm_medium=email&utm_source=footer> >>> . >>> 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 elixir-lang-core+unsubscr...@googlegroups.com. > To view this discussion on the web visit https://groups.google.com/d/ms > gid/elixir-lang-core/CAF9bs6RZHCC89TNF1YuWaEgCvRw1sDy% > 2BZWejBWfSeKreWMPhrQ%40mail.gmail.com > <https://groups.google.com/d/msgid/elixir-lang-core/CAF9bs6RZHCC89TNF1YuWaEgCvRw1sDy%2BZWejBWfSeKreWMPhrQ%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > > 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 elixir-lang-core+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/elixir-lang-core/CAGnRm4%2B%2BuSXj-L32qK9mdsMq-Lf6cCsAcKDtRqKzBa5%2B0QoGsA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
