Re: [elixir-core:8291] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
> I feel some kind of list in the getting started section might be more helpful, for newcomers to find them (like https://elixir-lang.org/getting-started/alias-require-and-import.html) I think this is a good idea: to add a page after 8. Modules and functions

Re: [elixir-core:8290] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
Okay: https://github.com/elixir-lang/ex_doc/pull/879#issuecomment-411102276 So tags is its own thing. I guess I'll take a look at how `:since` works & see what I can do for a searchable `:category` *tag*. English3000.org: *A data-driven approach to language learning.* On Fri, Sep 14, 2018 at 1

Re: [elixir-core:8289] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Sven Gehring
> Point being, you wouldn't put a function for integers in the `String` module, so why would you put functions that convert data [...] Well, Elixir doesn't. The only integer related functions in the String modules are conversion functions, which convert from/to Strings. If I want to convert between

Re: [elixir-core:8288] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread José Valim
His implementation is correct. It is about categories, not tags. A certain entry can only belongs to a single category. -- *José Valim* www.plataformatec.com.br Skype: jv.ptec Founder and Director of R&D -- You received this message because you are subscribed to the Google Groups "elixir-lang

Re: [elixir-core:8287] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
Okay. So then the tagging feature exists as *lackac * implemented it. However, the advanced search feature and `:category` metadata display (similar to how `:since` is displayed) do not. As I disagree with how he implemented it as a design pattern ( https://github.com/el

Re: [elixir-core:8286] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread José Valim
That pull request adds categories to the *sidebar*. But per my first comment, we are not going to adopt that style of sidebar organization to Elixir, at the level of granularity you propose, because it will cause confusing as it removes the alphabetical ordering. Other projects are free to adopt th

Re: [elixir-core:8285] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
Confused... [image: image.png] https://github.com/elixir-lang/ex_doc/pull/879 English3000.org: *A data-driven approach to language learning.* On Fri, Sep 14, 2018 at 10:30 AM José Valim wrote: > Yes, somebody needs to do this work in ExDoc though. Design the feature, > propose and implement i

Re: [elixir-core:8284] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread José Valim
Yes, somebody needs to do this work in ExDoc though. Design the feature, propose and implement it. Once this is supported in ExDoc, then we can discuss the best way to leverage it from Elixir itself. *José Valim* www.plataformatec.com.br Skype: jv.ptec Founder and Director of R&D On Fri, Sep 14

Re: [elixir-core:8283] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
Ok, then display them like you display the `since` data. And then add an advanced search feature (under the search bar) that leverages the tags to make functions show up by category. English3000.org: *A data-driven approach to language learning.* On Fri, Sep 14, 2018 at 10:15 AM José Valim wr

Re: [elixir-core:8282] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread José Valim
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

Re: [elixir-core:8281] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
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-b

Re: [elixir-core:8280] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Alexander Marks-Katz
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 word

Re: [elixir-core:8280] [proposal] make all callbacks optional by specifying the behaviour module

2018-09-14 Thread Hylke Alons
Thanks for your reply Louis! What would that look like? On Thursday, 13 September 2018 18:25:50 UTC+2, Louis Pop wrote: > > Hey Hylke! > > In the mean time you could parse the value contained in the @callback > attribute and generate a list of all the functions :) > > Cheers, > Louis > > On Th

Re: [elixir-core:8278] [Proposal] Add tags to Elixir core functions

2018-09-14 Thread Sven Gehring
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 or