Redesigning Haskell docs

Feb 4, 2018•
2 min read

haskellhackagehaddockdesignuipetprojecttypography

One of the first impressions most people mention having about Haskell is that it looks scary. Not just the concepts involved are overwhelming, but the documentation pages are not properly user-friendly and welcoming. Last December I decided to take action and propose a new design to the Hackage and the Haddock repositories.

More than a year ago I started playing with Elixir and I noticed quickly that all its official pages look consistent and welcoming. And after seven months working with Haskell daily at work, I realized that our community really misses something of that kind: a consistent, friendly and welcoming look.

Very recently some big names in the Haskell words, namely Simon Peyton Jones, have come forward with a proposal called SLURP: a Single Liberal Unified Registry of Haskell Packages. In that proposal they say:

Hackage has been extraordinarily successful as a single repository
through which to share Haskell packages. (…) But in recent years there has
been increasing friction over,

Pull requests

Preview

Using the links below you can preview how my latest changes look like on the given pages, as well how those pages currently look like.
I am hosting the preview pages myself, therefore those pages will keep on being updated accordingly to the changes I push. This is a better way to let others preview and actually try the changes compared to screenshots, which I was doing before.

So far the majority seems very positive about the new look&feel, but there is also feedback preferring the current theme.
The number one argument is that the current theme is dense in information, making it more suitable for quick glances and content searching.