ocaml.org icon indicating copy to clipboard operation
ocaml.org copied to clipboard

opam.ocaml.org should make it easier to find package documentation.

Open patrick-nicodemus opened this issue 1 year ago • 0 comments

Currently, the page at https://opam.ocaml.org/packages/core (substitute your favorite OCaml package here) does not contain any kind of links or pointers to documentation.

Say I want to find documentation on OCaml package packagename. I will often Google "ocaml packagename" or "opam packagename". Frequently the first link that I find is to https://opam.ocaml.org/packages/mypackage/.

It is not clear imo from browsing https://opam.ocaml.org/ where one should look for documentation for any of the packages listed on this site, one cannot interactively discover the page ocaml.org/p/packagename or any hint that all the documentation for all of the packages is hosted on a totally different part of the website. Ideally, https://opam.ocaml.org/packages/mypackage should link prominently to ocaml.org/p/mypackage, perhaps also opam.ocaml.org should link to ocaml.org/packages.

patrick-nicodemus avatar Apr 16 '24 13:04 patrick-nicodemus