<div dir="ltr"><div dir="auto">ter+1 on that clipboard idea!</div><div dir="auto">I really need to get to work on <font color="#1155cc"><u><a href="https://github.com/erldocs/erldocs_other">https://github.com/erldocs/erldocs_other</a></u></font></div><div dir="auto">and to incorporate your <a href="https://github.com/crownedgrouse/geas">https://github.com/crownedgrouse/geas</a> project Eric!</div><div dir="auto"><br></div><div dir="auto">I have been spending some time in golang doc pages... they have examples as well as links to source code. Erldocs.com should be more like that. I don’t have a bounty to suggest but I’ll review pull requests. </div><div dir="auto"><br></div><div dir="auto">WRT doing some ML on the corpus of open source Erlang projects:</div><div dir="auto">the <a href="http://other.erldocs.com">other.erldocs.com</a> project aims to aggregate the data & to help anyone process it for the greater good.</div><div>It just needs finishing...</div><div><br><div class="gmail_quote"><div>On Sat 2 Dec 2017 at 11:36, PAILLEAU Eric <<a href="mailto:eric.pailleau@wanadoo.fr" target="_blank">eric.pailleau@wanadoo.fr</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">+1<br>
<br>
Erlang release version of first introduction would be as well very<br>
usefull for people wanting to let their code compatible with some releases.<br>
Edoc tag  @since  exists...<br>
<br>
Another annoying thing I think is that documentation does not help to<br>
write your code quickly :<br>
<br>
in documentation you got for instance for maps module :<br>
<br>
find(Key, Map) -> {ok, Value} | error<br>
<br>
I offen copy and paste possible return values for a 'case' and have to<br>
rewrite all. As well module name is missing, having to always think to<br>
add it.<br>
<br>
Would be very nice to have a prepared case statement with all possible<br>
return value in clipboard when clicking on function.<br>
case maps:find(Key, Map) of<br>
        {ok, Value} ->  ;<br>
         error       -><br>
end<br>
<br>
<br>
Le 27/11/2017 à 08:06, <a href="mailto:ok@cs.otago.ac.nz" target="_blank">ok@cs.otago.ac.nz</a> a écrit :<br>
> An alphabetic list has two uses:<br>
>   1. find a function with (approximately) known semantics<br>
>      but unknown name<br>
>   2. find the documentation for a known name.<br>
><br>
> Splitting the documentation into two lists hurts 2 without<br>
> actually helping 1.<br>
><br>
> A more informative approach would be to have a line<br>
> added: 12.3 deprecated: 20.3 to be removed: 24.0<br>
> perhaps with dates, and it should be possible to generate at<br>
> least the 'added:' and 'deprecated:' parts automatically.<br>
><br>
> "added" = JavaDoc "since".  Compare also the macOS X<br>
> __OSX_AVAILABLE_STARTING(<<wbr>macos vsn>, <ios vsn>)<br>
> __OSX_AVAILABLE_BUT_<wbr>DEPRECATED(<macos in vsn>, <macos out vsn>,<br>
>      <ios in vsn>, <ios out vsn>)<br>
><br>
><br>
> ______________________________<wbr>_________________<br>
> erlang-questions mailing list<br>
> <a href="mailto:erlang-questions@erlang.org" target="_blank">erlang-questions@erlang.org</a><br>
> <a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/<wbr>listinfo/erlang-questions</a><br>
><br>
<br>
______________________________<wbr>_________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org" target="_blank">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/<wbr>listinfo/erlang-questions</a><br>
</blockquote></div></div></div>