Documentation of Haskell websites, servers and their configurations

#1

I am starting a project to collect all useful documentation of Haskell websites, servers and their configurations. The purpose is to

  • obtain up-to-date information
  • make this information public
  • encourage volunteers in maintaining and improving the sites and their configuration
  • soliciting suggestions and requests for changes and improvements from the community

Much of this information is available, but it is scattered. Initially I want to collect this information in the Haskell wiki, but I hope it will be the germ for official documentation as desired by the Foundation and the haskell.org committee. I am open to using alternative venues.

3 Likes
#2

There is a place with information, and which is public, and a team which works on this: https://github.com/haskell-infra/haskell-admins

That said, PRs to improve the information, or volunteers to work on things are extremely welcome.

2 Likes
#3

The https://gitlab.haskell.org/ server runs NixOS; its configuration is also tracked in version control. However, this repository is not public due to the presence of secrets in the repository. At some point we really ought to encrypt these and rewrite history to drop the plaintext versions but this has not been a priority thusfar.

#4

I’m sure you know this already, but if you’re going to reveal a git history that once contained credentials then you should change those credentials, just in case the attempt to rewrite history was not 100% successful.

1 Like
#5

If there’s any not secret stuff you think could be useful to keep more accessible in terms of documentation, (or just you want to add some info on how its adminned, etc) a PR to the haskell-admins repo with that could be very useful :slight_smile:

1 Like