[RFC] Documentation overhaul on haskell.org

Yup.

A battle-proven (as in: “what several Linux distributions do”) recipe goes like this:

  1. Open one or several GitHub repos, seeded with a static web site generator.
  2. Work there, enjoying the well-known workflow and the visibility that the platform offers you. Build the docs whenever you feel like. Serve using GitPages or anywhere else (HFoundation for example).
  3. When you feel like you’ve grown enough that GitHub is more of a constraint than anything else, for instance when you need to coordinate several repositories, or when you want to really be in control of your files, you set up a Pagure instance on, say, the HFoundation’s infrastructure, with its own internal repositories, leaving behind the GiHub repos as mere mirrors for safety and visibility.

After (3), there is one remote hub for hosting and working on the docs, but the docs is still decentralized in the sense that anyone can replicate the whole at home and work on it offline.

6 Likes