Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Take the documentation of GenStage, for example. It is a dry transition between what a stage is into advanced concepts with diagrams are in ASCII. https://hexdocs.pm/gen_stage/GenStage.html

Not only this article dumps significant cognitive load on the reader. It's not well digested and not a soft landing into the subject. Worst of all, many Elixir articles assume familiarity with GenStage.

Compare it to this, which is not the best example but is a much more soft landing. https://doc.akka.io/libraries/akka-core/current/typed/actors...



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: