[erlang-questions] dialyzer output help
Mon Aug 10 15:06:47 CEST 2015
On 08/10/2015 03:04 PM, Roelof Wobben wrote:
> Op 10-8-2015 om 14:56 schreef Loïc Hoguin:
>> On 08/10/2015 02:51 PM, Garrett Smith wrote:
>>> On Mon, Aug 10, 2015 at 7:47 AM, Loïc Hoguin <essen@REDACTED> wrote:
>>>> Separate the documentation from the code
>>> For documenting modules along the lines of erlang.org's reference
>>> material  what do you do?
>>>  E.g. http://erlang.org/doc/man/lists.html
>> This is what *they* do:
>> What I do is similar, except using Asciidoc:
>> (Tried a few formats over the years, settled on that one recently,
>> don't think I'll switch again. :-)
> But now I more confused.
> Im reading the introducing erlang book and there is always stated to
> document your code.
> I find this the most difficult part because how do I document something
> like the area function.
I think for commenting code, Garretttt's advice was spot on. If you make
the code readable on its own, mainly through the use of proper function
and variable names, you don't need to put a comment above it to explain
how it works.
Author of The Erlanger Playbook,
A book about software development using Erlang
More information about the erlang-questions