dhall-haskell
dhall-haskell copied to clipboard
Ideas to make `dhall-docs` more easy to discover
Today I found this comment on the #dhall channel at functional programming slack's workspace:
https://functionalprogramming.slack.com/archives/C82N1L0MB/p1600199375075200?thread_ts=1600157283.069200&cid=C82N1L0MB
What can we do to make dhall-docs easier to discover? I'm thinking of:
- Adding an entry to docs.dhall-lang.org or dhall-lang.org
- We could add a reference to the tool in the generated HTML, similar to haddock's generated footers (see the footer of this example)
In the README page of dhall-kubernetes a link to the generated dhall docs would be one easy way to draw attention.
I think the first step is deciding what subdomain of dhall-lang.org to use (since docs.dhall-lang.org is already taken). Then we could start hosting documentation for a few selected packages (e.g. the Prelude and dhall-kubernetes) underneath there until we have something more systematic.