The Elixir ecosystem has very convenient and powerful facilities for documenting code. These include Markdown, doctests, module attributes, typespecs, etc. By now, there should be some great examples of using these in practice.
So, I’d like to hear folks’ opinions on some code bases that use these facilities in an exemplary manner. Ideally, there would be links to particular files, accompanied by a discussion of why they rock.
It’s fine to promote some approaches and/or critique others, as long as it’s done in a friendly, positive, and respectful manner. The goal is to have a productive discussion, giving folks ideas on how to improve the documentation in their own code bases.
-r
