Comments (8)
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?
from ex_doc.
I would honestly move records to the regular group. Leave the other tabs
being Protocols and Exceptions.
from ex_doc.
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
.
from ex_doc.
That's going to be a lot of tabs.
from ex_doc.
@pminten One more tab than there is today (Exceptions).
from ex_doc.
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?
from ex_doc.
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.
from ex_doc.
@pminten Ah, that's a good point. So maybe that is the distinction we should make.
from ex_doc.
Related Issues (20)
- Add syntax highlighting for JavaScript/TypeScript HOT 3
- links for otp apps' (gen_tcp/ssl) types use old format HOT 4
- Bullet list not displayed correctly HOT 4
- Better integrate Erlang/Elixir
- Mobile: Search bar is too sensitive to page scroll HOT 2
- Warn about docs for out-of-date versions HOT 1
- Odd Gradient with mobile breakpoint in light mode HOT 1
- feature request: Link to Anchor callback/function auto-links like with Modules and Extra pages
- Possible error when deprecating binaries path for assets HOT 4
- Failure to render links for specs when using Elixir 1.17 or later HOT 1
- No support for debug_info keys? HOT 1
- Search page shows no results even though autocomplete finds them HOT 1
- Signs in integer literals trigger warning HOT 3
- More explicit warning when type not visible because module is not visible HOT 2
- Fail to generate docs due to earmark_parser_string_lexer not available HOT 2
- Remove support for application/erlang+html HOT 4
- Screen reader text obscures search HOT 10
- No information on how to run locally HOT 2
- Admonition blockquotes should be converted to divs HOT 1
- Sidebar missing until mermaidjs finishes loading HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from ex_doc.