[RFC] Documentation overhaul on haskell.org

Time to bring in the professionals!

The HF can hire a team of three experienced “web-publishers” to go through the content on both www.haskell.org and wiki.haskell.org with a view to building something like the proverbial “Rust book” - for anything they consider irrelevant to the task (particularly on the wiki), the authors of the original page can be contacted to move their content elsewhere, otherwise it can be archived e.g. as a .zip or compressed .tar file, for future cyber-historians to download from e.g. archive.haskell.org as needed.

Regarding the wiki, if several of the comments here are any measure:

…then the site (and “centrally-located” wikis more generally) have mostly served its purpose, and can now be retired:

  • Again for those future cyber-historians, a "full page archive" (including all page histories) in a suitable compressed format;

  • For people who actually want to keep the wiki going on an alternate site, a “meta-data archive” from the current wiki server (which would also include all the data in the "full-page archive");

  • For everyone else, a “final-version archive”, just containing the most recent snapshots of all pages or their final versions, if the wiki is going offline permanently.

Of course, these are just suggestions, with the final decisions being left to the publishing team - if we don’t like what they choose, we as a community should have done what’s required for ourselves. Clearly that didn’t happen.

(In case you’re wondering: yes - I’m the author of several recently-added pages on the wiki, so I too will most likely be affected by this course of action. But having stale content from the wiki constantly appearing in search results will only have more people wondering about the future of Haskell…)

2 Likes