Dev meeting 2021 01 28

Jon Ludlam edited this page Feb 18, 2021 · 1 revision

Agenda

Attendees

@jonludlam
@avsm
@lukemaurer
@lpw25
@lubegasimon
@Octachron
@Julow
@Drup

Support statement

Big discussion last meeting was on the need for a small support statement.

Draft PR here: https://github.com/ocaml/odoc/pull/571
Omissions - do we want to fix them all? specifically, embedded html tags?

@lpw25: it used to support html tgs, and section 8.18 - in the manual - has doc comment association rules

Beta release requirements

none now? odig fixed

2.0 release

issues marked on github, migrating some from 'replace ocamldoc' milestone. CI for dune/ocaml (odoc configure flag)/odig
there is a desire for showcase docs to demonstrate what odoc can do now. Suggested projects: yaml and tyxml
mdx -> ocaml-doc org and octavius (or odoc's parser) too

Mdx and "Extract code blocks by id" PR

Suggestion: define concrete syntax for passing string to mdx (e.g. 'env=e1' or 'version>=4.06') then defer entirely to mdx

Showcase docs for the 2.0 release