Jon Ludlam

@hidden would be a useful tag to have on items

20

Rather than putting the item between `(**/**)` comments - it's easier for ppxes.

Odoc does not ignore tags where they don't make sense

8

e.g. [@param] tags on instance variables are rendered. See https://ocaml.org/releases/4.12/htmlman/ocamldoc.html#ss:ocamldoc-syntax for a more detailed description of the expected behaviour.

Broken link in Tyxml

2

In [this element](https://docs-staging.ocaml.org/packages/tyxml/4.5.0/Tyxml_html/index.html#module-Xml) there is a link to `Txml_xml.W.t`, the URL of which is [broken](https://docs-staging.ocaml.org/packages/tyxml/4.5.0/Tyxml_xml/W/index.html#type-t).

Unable to refer to some elements in unapplied functors

1

For example: ```ocaml module X : functor ( Y : sig type t end ) -> sig module Z = Y end (** {!X.Z.t} *) ```

Failure to expand complicated functor

2

The functor `App` in the following does not produce an expansion: ```ocaml module type Type = sig module type T end module App : functor (T : Type) (F :...

Markdown output

1

We would like to be able to render to a markdown document.

Add canonical tags to a few types so odoc knows where to find them

2

Currently the docs are either missing tags where they contain hidden items or linking to hidden modules. See ocaml/odoc#1091

no docs for odoc :-(

5

There are no docs for odoc on ocaml.org - this appears to be a problem with the solver - https://docs.ci.ocaml.org/package/odoc.2.4.1 shows ``` Error from solver: Bad frame from worker: time="1.36"...

I was checking the odoc PRs and started to question my own sanity. I'm certain that 2 days ago when I made a particular PR it passed the checks. In...

We were only using it for 2 functions, both of which are in stdlib. Unfortunately they're also added in 4.03 and 4.04, and we support 4.02, so the code has...