the ocaml.org maintenance team is working diligently to bring you desperately needed UI/UX improvements. Starting right now, we are working with a UI/UX designer (hi Claire!) to make sure that the changes we make improve your experience on the site while also looking nice!
We’re running a (short) user survey via Google forms on the package documentation and learn areas with two goals:
to get a broad overview of what the most pressing UI/UX issues to fix are, and
to recruit some participants for interviewing them in a 20 minute video chat with Claire (optional)
Claire is an experienced UI/UX designer, but not a developer, so having the opportunity to get to know the community while also learning what problems you are experiencing on ocaml.org is very useful to bring her up to speed.
It is likely that there will not be enough time to interview everyone who offers to help, but if you get invited to an interview with Claire, do not hesitate to show her what is, according to your experiences, wrong or broken with the package documentation and learn area on ocaml.org.
Fixed, ty for mentioning. This slipped past us, but indeed, research and the possibility that someone is using OCaml for multiple purposes makes sense!
I commit to posting a higher-level summary on January 20 in this thread, but not people’s individual answers. This is for privacy reasons (and so that you don’t hold back describing, even if it may personally identify you).
So much so that I took the trouble to create a little script on my iphone to remove it (a few weeks ago).
It’d be nice if you could find a way to make accessing the sub-menu items less “intrusive”. IMO putting everything into the hamburger menu would be fine and not surprising at all.
If you allow me to repeat myself (I mentioned this a couple of times I think for various places of the documentation), here concerning the ‘playground’:
I still don’t understand why it is illustrated with this horrible implementation of Fibonacci.
If you use the proposed algorithm to compute for instance fib 50,
I think you can do the computation by hand (pen and paper) faster than the computer!
Whereas the “normal” recursive algorithm for Fibonacci gives the answer instantaneously.
This will potentially make people visiting this page think “Oh my, they don’t know what they’re talking about in this community”
I don’t manage to keep up to date with all the discussions on here, so repetition is definitely welcome.
Do we have a better code example that shows off the new multicore support on OCaml 5? With issues like this one, I’d be super happy when someone opens an issue on GitHub - ocaml/ocaml.org: The official OCaml website. to propose a better code example. I can get these added and merged very quickly.
I recently realized that Brave browser enables speed reader mode automatically for some pages. In this mode monospace font has two weird sizes. I’m not sure if original web-site can control it, but I wrote this down anyway
I understand that (and why) everybody in the community is enthusiastic about multicore, but
it this clear that such a “playground” area should display this new feature?
Do you have an idea of who is using this page? My impression is that it was more targeted to beginners, and then more basic codes would be more appropriate (?)
There is no way you can miss that documentation link as your attention is naturally drawn to it reading top down, from the center of the page.
Also, thinking about it more, the center and largest portion of the page for a given package on ocaml.org being mostly blank gives an overall impression of “emptyness” on desktops. Perhaps that could be improved?
Here’s the link to the Elixir package page mentioned above, for inspiration. IMO whoever created those pages got many things right and their implementation could be used as a reference.
I find the Learn page particularly hard to navigate (Mozilla Firefox 91.13.0esr on Debian 11):
Thank you for including the browser version - this is quite different from what I see on all the browsers I have installed and clearly not what was intended here. Are there any nonstandard settings (e.g. font size) used?
Clearly, the intention of ocamlformat here is to link directly to the documentation. After we fix the URL structure to allow people to link to the latest version of the documentation of a package (Adding latest url to package links by SaySayo · Pull Request #793 · ocaml/ocaml.org · GitHub), the link on the GitHub repository’s README can be updated to go directly to the documentation.
