--- tags: minutes --- # Odoc dev meeting 2021-03-25 ## Attendees @jonludlam @lortex @lubega-simon @julow @lpw25 @Drup ## 2.0 issues ### New: - Memory issues noticed in JS. Issue to be created. - Strengthening in the presence of Module Type Of - possibly down to strengthening with a hidden module. Issue to be created. - [#650](https://github.com/ocaml/odoc/issues/650) (Need ModuleType 'aliases') - suggestion: 2.0.0 (otherwise would break links) - [#648](https://github.com/ocaml/odoc/issues/648) (Warnings about ambigous references are bogus) - suggestion: 2.0.0, with 'check' issue - [#645](https://github.com/ocaml/odoc/issues/645) (Comment attached to include are dropped) - PR in progress - always drop the top comment in the signature expansion - take the top-comment in @inline includes that are the first item of a sig - [#636](https://github.com/ocaml/odoc/issues/636) (Renderers: allow for unqualified identifier rendering) suggestion: post 2.0.0 - [#651](https://github.com/ocaml/odoc/issues/651) ( Improve tests for generators (html, man, and latex)) ### Fixed since last time: - [#590](https://github.com/ocaml/odoc/issues/590) (Enable references to refer to pages with '.' or '-') - [#541](https://github.com/ocaml/odoc/issues/541) (Alignment "styles" (Center, Left, Right) are not supported) - @lubegasimon - [#328](https://github.com/ocaml/odoc/issues/328) (No code change) - [#631](https://github.com/ocaml/odoc/issues/631) - PR [#640](https://github.com/ocaml/odoc/pull/640), also fixes [#235](https://github.com/ocaml/odoc/issues/235) ### PRs open: - issue [#632](https://github.com/ocaml/odoc/issues/632) (No synopsis rendered for modules) - PR [#643](https://github.com/ocaml/odoc/pull/643). Some discussion happened - good to merge now? - [#644](https://github.com/ocaml/odoc/pull/644) - documentation of how to write comments in modules - issue [#559](https://github.com/ocaml/odoc/issues/559) (Canonical does not work on compilation units) - PR [#649](https://github.com/ocaml/odoc/pull/649) ### In progress: - [#460](https://github.com/ocaml/odoc/issues/460) (reference driver needed) - in progress, on hold - [#573](https://github.com/ocaml/odoc/issues/573) (docs are bad) - in progress, on hold - [#557](https://github.com/ocaml/odoc/issues/557) (Command to extract errors from odocl files) - @jonludlam to fix - [#478](https://github.com/ocaml/odoc/issues/478) (Top-level doc-comments of module types are discarded) - @Julow - is this now fixed? ### Unstarted: Just the new issues ## docs.ocaml.org @lortex working hard on this - excellent progress! (demo??) https://ci.mirage.io/wip/packages/index.html ## Next meeting - 2021-04-08 ? Check due to Easter vacation plans?