Missing ocaml.org package documentation

The generated documentation for (all?) OPAM packages (and for all versions?) seem to be missing from ocaml.org for some days now (maybe a week?). The package overview pages are still there, and I see an older thread in Site Feedback saying the documentation resides on a separate set of servers. Are those servers having problems?

Indeed, the docs server has suffered something nasty! The doc artifacts themselves have survived, we think, so we should be able to get them back up soon. The rest of the state is gone though, so we’re going to have to rebuild all the packages from scratch, which takes a while. The visible result is that we’ll have soon have docs back up for everything in opam-repository up until a few days ago. Anything newly merged to opam-repository might take a week or so before the docs show up. Sorry for the disruption!

2 Likes

The machine is now back and serving docs. There may be some delays while the missing docs are generated.

3 Likes

Dear @jonludlam,

interesting to hear about that. Would you mind to share details what “something nasty” is? And how a future “something nasty” may be mitigated?

Thanks a lot for your work and keeping the docs browsable! :slight_smile:

3 Likes

It’s a good question! Something zeroed out the docker partition on the build machine - @mtelvers might know more as he fixed it. The HTML artifacts are not in a docker volume but stored elsewhere so they survived.

To answer your second question, the current docs build is quite brittle in a number of ways, so we’re looking at replacing it with something that will hopefully be a bit more stable - and quite a lot faster too, based on Mark’s day10.