Discern between exceptions and records about ex_doc

[pminten]

It's a bit complicated as there's also things like modules which can be used as behaviours, who have a special tag in ex_doc right now. And we're likely to see more of these as Elixir evolves.

I do understand your point though and having the exceptions clutter up the records list isn't ideal.

This discussion is likely to go much broader than exceptions and records fairly quickly, so can we move it to the mailing list?

[josevalim]

I would honestly move records to the regular group. Leave the other tabs
being Protocols and Exceptions.

[ericmj]

IMO, it should be Modules, Protocols, Exceptions, Records. Behaviours should be in Modules like it is today. Anything that has a special macro for generating a form of module should have a separate tab. defmodule, defprotocol, defexception, defrecord.

[pminten]

That's going to be a lot of tabs.

[ericmj]

@pminten One more tab than there is today (Exceptions).

[josevalim]

The thing is that records are going to be even less important once R17 is out. And I think putting them together with modules makes sense from the user perspective. For example, a HashDict is a record, a Range as well, why you need to search one in one tab and the other in the other?

[pminten]

But with HashDict how would you (as user) know that it's really a data type "object" module? Specifically knowing that HashDict can be used with defimpl would be useful.

[josevalim]

@pminten Ah, that's a good point. So maybe that is the distinction we should make.