ocaml / ocaml/ocaml.org

Please make list of OCaml releases and source code easier to find

Open
#447 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

ui v2
Dominant language
Markdown
Stars
192
Forks
389
Avg merge
23h 8m
Merged PRs (30d)
20

Description

On v2.ocaml.org there is a News entry right near the top showing 4.14, very easy to find.
On v3.ocaml.org (and now ocaml.org) I had to search quite a bit until I realized that there is a link to the list of releases at the bottom of the page (there is also no 'News' section). I'm sure I'll eventually get used to the new site, but I haven't realized (until the default got switched to v3) that some places I often visited on the old site were more difficult to locate on the new one.
Once located the ocaml.org/releases page does look a lot nicer than the old releases page 😄

Places I tried looking:

  • 'Get Started' - which tells how to install using package manager. Please add a link here to ocaml.org/releases, e.g. on the left next to 'Documentation' or 'Language Manual'
  • 'About OCaml' - no link to releases here either. Please add a link to the releases.

I think it would be useful to make the link to the releases more prominent on the landing page (ocaml.org too), either by adding it to the top nav bar or near 'Get Started', 'About OCaml'.
It is always useful to be able to easily check what the latest release is (just in case I missed an announcement).

There is a link to GitHub at the very bottom of the page, which is not the place I was thinking of looking for it (previously I don't think it was at the bottom). There is so much white space at the top of the page, surely it should be possible to add a few links/icons there too.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Inspect the ocaml.org landing page and the existing Get Started, About OCaml, and releases pages. Add prominent navigation to the releases list and source code where appropriate, then verify that visitors can find the latest release and repository without searching.

Written by the indexing model from the issue text.

Assessment

Tech stack
ocaml
Domain
content, web-dev
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.