Re:The BEAM Has Spoiled Me
by Kaze404 on Saturday August 15, 2020 @09:36PM
(#24174071)
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.
[ Parent
| on HN ]
Re:The BEAM Has Spoiled Me
by OkayPhysicist on Sunday August 16, 2020 @03:23AM
(#24175930)
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.
IMHO many function docs could have more examples.
Especially for a dynamic language which uses tuples/maps for a lot of arguments.
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.