>
> Regarding ExDoc, I would use the first arity to create the link (Erlang
> documentation seems to do the same). For example `Module.fun/1,2` would
> link to `Module.html#fun/1`; and `Module.fun/4,3` to `Module.html#fun/4`. I
> like this option because it allows developers to control were the link is
> going to point to. I’ve discarded the option of creating multiple anchors
> like `#fun/1,2` to avoid the combinatorial explosion of cases like
> `#fun/1,2,3,4`.
>

Would we use this for functions with default arguments too or only for
custom multiple-arity functions which relate to each other?

I think most of the multiple-arity functions will end up being functions
with default arguments where the documentation is attached to the largest
arity function. Therefore, I would recommend using the largest arity in
that case. We could still use `Module.fun/3,1,2`, but I would prefer
`Module.fun/1,2,3`. What do you think?

-- 
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 [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/elixir-lang-core/CAA2aWVRLOxe09PgftZpOVzciTqtaoaPAPmbgcd7pPSc1QFyi%2Bg%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to