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/msgid/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/topic/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/msgid/elixir-lang-core/CAFuVuxwMu3wh%3DC%2B2Lo2emziY%3DMZAucxXqUCrsMdTLrL3bL4bRQ%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/msgid/elixir-lang-core/CAF9bs6Q%2B-4aa8yNEs7mUVDuef1bUkGNPX6umE_2UiurBmd-zKA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
