Hacker News Reader

The killer feature for me was the documentation. I got thrown into an Elixir application that uses Ecto and Phoenix and literally everything I ever had to do was documented and explained in Hexdocs.

View on HN

Seriously, the Elixir documentation should be considered the gold standard. Almost everything is documented with exactly what kind of situations the library/module/function should be used for, combined with illustrative examples showing how it should be used.

Coming from Erlang to Elixir - I find Elixir docs lacking in both coverage and terseness.

I could agree. Coming to Erlang from Elixir, I truly appreciate the simplicity and small size of the Erlang language. Making it possible to write exhaustive documentation. In fact, in Joe's book he defers a lot to the online docs/manual for in-depth treatment of a lot of topics.

While you might be right, I dislike the style of Erlang docs.

IMHO many function docs could have more examples.

Especially for a dynamic language which uses tuples/maps for a lot of arguments.

Reply on news.ycombinator.com