# Missing ocaml.org package documentation

**URL:** <https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977>\
**Category:** Site Feedback\
**Created:** [April 10, 2026, 12:57pm UTC](https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977 "2026-04-10T12:57:58Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![fnfun](https://avatars.discourse-cdn.com/v4/letter/f/919ad9/32.png) [@fnfun](https://discuss.ocaml.org/u/fnfun)\
**Post date:** [April 10, 2026, 12:57pm UTC](https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977/1 "2026-04-10T12:57:59Z")

</div>

The generated documentation for (all?) OPAM packages (and for all versions?) seem to be missing from [ocaml.org](http://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?

---

<div class="post-metadata">

**Author:** ![jonludlam](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/jonludlam/32/101_2.png) [@jonludlam](https://discuss.ocaml.org/u/jonludlam)\
**Post date:** [April 10, 2026, 2:20pm UTC](https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977/2 "2026-04-10T14:20:09Z")

</div>

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!

---

<div class="post-metadata">

**Author:** ![mtelvers](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/mtelvers/32/5834_2.png) [@mtelvers](https://discuss.ocaml.org/u/mtelvers)\
**Post date:** [April 10, 2026, 3:14pm UTC](https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977/3 "2026-04-10T15:14:52Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![hannes](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/hannes/32/2302_2.png) [@hannes](https://discuss.ocaml.org/u/hannes)\
**Post date:** [April 11, 2026, 2:10pm UTC](https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977/4 "2026-04-11T14:10:06Z")

</div>

Dear @jonludlam,

> [@jonludlam](#):
>
> 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

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! 🙂

---

<div class="post-metadata">

**Author:** ![jonludlam](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/jonludlam/32/101_2.png) [@jonludlam](https://discuss.ocaml.org/u/jonludlam)\
**Post date:** [April 14, 2026, 3:17pm UTC](https://discuss.ocaml.org/t/missing-ocaml-org-package-documentation/17977/5 "2026-04-14T15:17:52Z")

</div>

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](https://github.com/mtelvers/day10).
