Thicket data repository for the EEG
anil.recoil.org
1{
2 "id": "https://jon.recoil.org/blog/2025/05/docs-progress.html",
3 "title": "Progress in OCaml docs",
4 "link": "https://jon.recoil.org/blog/2025/05/docs-progress.html",
5 "updated": "2025-05-29T00:00:00",
6 "published": "2025-05-29T00:00:00",
7 "summary": "Summary",
8 "content": "<h1><a href=\"#progress-in-ocaml-docs\"></a>Progress in OCaml docs</h1><ul><li><span>published</span> <p>2025-05-29</p></li></ul><p>The docs build is progress well, and we've <i>just about</i> hit 20,000 packages (20,038 to be precise). So at this point I thought it'd be useful to take a look through the various failures to see if there are any insights to be gained.</p><p>Odoc requires a built package in order to generate the docs, there are two steps that have to be done before we can begin building the docs. Step one is to figure out the exact set of packages to build - ie, doing an opam solve, and step two is to actually build the packages. These two steps are, to some extent, out of docs-ci's control, and rely on the state of opam repository. While there are efforts to keep this in as good a state as possible, it's still the case that these steps fail much more often than the actual docs build itself. Let's take a look at some of the failures we see in each of these steps.</p><p>Continue reading <a href=\"https://jon.recoil.org/blog/2025/05/docs-progress.html\">here</a></p>",
9 "content_type": "html",
10 "author": {
11 "name": "Jon Ludlam",
12 "email": null,
13 "uri": "https://jon.recoil.org/"
14 },
15 "categories": [],
16 "source": "https://jon.recoil.org/atom.xml"
17}