3 ms·
This is pretty standard practice. The landing page for a package is never where examples live (except for the README). Haddocks are used for examples & tutorial
by whateveracct 7y ago
This is pretty standard practice. The landing page for a package is never where examples live (except for the README). Haddocks are used for examples & tutorials, and the top-level module or a documentation-only module ending in ".Tutorial" are often provided.
- weavie 7y agoSure. It just took a bit of getting used to, but could be the reason why a lot of casual developers looking at the language have the impression that the documentation is poor.
- whateveracct 7y agoThat's fair I guess but if someone just looks at a single landing page and draws a conclusion without even clicking around idk what to say
- lonelappde 7y agoRight, and that's the problem. We just had a massive thread about th importance of good landing pages. The package home page needs a README with links to wherever the good stuff lives. Look at how GitHub does it.