Mon 24 Aug 2026 11:25 - 11:50 at HO223 Indiana Room - OCaml Workshop Watch Party 2

OCaml’s centrally-generated documentation site, ocaml.org, serves API documentation for almost every opam package, complete with rendered source, type-aware search and cross- package links. Locally, however, documentation remains sec- ond class: building the docs for a project and its dependencies requires slow, non-incremental tooling that must rediscover information the build system already had. We propose a sim- ple change with far-reaching consequences: each package should build and install its own odoc files, just as it installs its compiled artifacts today. This removes the discovery problem that complicates every existing documentation driver, and makes first-class experiences straightforward to build: docu- mentation available on install, fast incremental rebuilds with actionable errors in the IDE, CI checks for broken docs, and local search. We survey the current documentation pipeline, describe the challenges facing per-package build rules, and outline a migration path, including an opam-hook-based emulation that is usable today.

Mon 24 Aug

Displayed time zone: Eastern Time (US & Canada) change

11:00 - 11:50
OCaml Workshop Watch Party 2(Watch Party) OCaml at HO223 Indiana Room
11:00
25m
Talk
Towards a Benchmarking Service for OCaml
(Watch Party) OCaml
11:25
25m
Talk
First Class Docs in OCaml
(Watch Party) OCaml
Jonathan Ludlam University of Cambridge