The documentation is good because it usually shows examples for all parameters types, something I miss regularly in the Elixir docs for example.

I agree that the comments should be removed or at least hidden by default as they're usually not relevant anymore.