Original bug ID: 4085
Reporter: @hcarty
Assigned to: @mshinwell
Status: resolved (set by @mshinwell on 2016-12-06T21:29:36Z)
Resolution: fixed
Priority: normal
Severity: feature
Category: documentation
Monitored by: ertai

Bug description

As a person interested in the OCaml language but unfamiliar with the language or its surrounding community, I have found it quite difficult to sort through the existing documentation to find out what is relevant to the current state of the OCaml language and related tools and what is out of date.

One specific example of this is the revised syntax documentation - the document indicates that the syntax is different from the "normal" syntax, but there is no indication of its use or continued development/maintenance. It seems to be a relatively minor issue once one has started using OCaml and working with the community, but it is a barrier for entry when something as simple as syntax is left ambiguous.

Another example is the development of OCaml itself. To be quite honest, from the outside the project looks almost completely stagnant. Some form of news or other information access on the future direction/development of the language and tools would be both useful and comforting for potential users of the language.