---
# System prepended metadata

title: Minutes of docs.ocaml.org meeting
tags: [minutes]

---

---
tags: minutes
---

# Minutes of docs.ocaml.org meeting

## Attendees

@jonludlam 
@julow 
@lortex 
@avsm 
@dra27 
@lubega-simon
@samoht
@patricoferris 
@ILeandersson
@Sonja


## Demo!

- Ocurrent pipeline builds docs for all ocaml packages
- Has to be _incremental_ 
- Tracks opam repository
- Builds packages using obuilder - so long as it can build with ocaml >= 4.02

Note: this is a reason to ensure your package can be built by CI!

- Track - list packages,  uses 0install solver to  find a solution 14,000 packages can be solved currently.

avsm: thiswould be an excellent multicore example

avsm: this could be combined with  healthcheck -  so actually we don't minimise the  different  solutions, but actively resolve every so often. Then publish build failures instead of docs, which gives people an incentive to fix the build!

avsm: might be useful to have actual database here - it's an eventually consistent problem

prep step is expensive - lots of open files as each job is done in parallel
prep could store results in s3 rather than ssh server

looks a bit like nix! GC a problem?

yes, GC is a problem - a week of package building ended up tripling the amount of space used in the universes hierarchy. 

patrick: what about packages that  only compile on other OSes?
this should work! can read the cmtis under linux. Complicated solver issue though!

bless step:

Pick the version with the  most deps - this catches optional dependencies.




Demo of new index pages - uses a dynamic server to put the versions links in the top bar.

avsm: creeate a database with  the info in to drive search  and so on. This  is the heart  of the new website!

need a url - hump? small to type :-)

want to be able to group packages together e.g. jane street / mirage / citrix

Website repository to be published soon, probably quietly.

NEXT STEPS: tailwind css version of the HTML renderer in odoc
Weekly meeting until the new website is published.

