Welcome to the April 2024 edition of the OCaml.org newsletter! This update has been compiled by the OCaml.org team. You can find previous updates on Discuss.
Our goal is to make OCaml.org the best resource for anyone who wants to get started and be productive in OCaml. The OCaml.org newsletter provides an update on our progress towards that goal and an overview of the changes we are working on.
We couldn’t do it without all the amazing people who help us review, revise, and create better OCaml documentation and work on issues. Your participation enables us to so much more than we could just by ourselves. Thank you!
This newsletter covers:
- OCaml Cookbook: We shipped a new, community-driven section in the Learn area. Help us make it really useful by contributing and reviewing recipes for common tasks!
- Community & Marketing Pages Rework: We have UI designs for the reworked and new pages of the community section and are starting work to implement these.
- General Improvements: As usual, we also worked on general maintenance and improvements, so we’re highlighting some of the work that happened below.
Open Issues for Contributors
You can find open issues for contributors here!
Here’s some new (and as of time of writing this newsletter still open) issues that were opened this month:
- Package Versions page is missing dark mode styles ocaml/ocaml.org#2341 by @sabine
- (Data) Extend the Data Model of Academic Institution to Record Information about Course Materials ocaml/ocaml.org#2328 by @sabine
The OCaml Cookbook
We shipped a new, community-driven section in the Learn area: the OCaml Cookbook!
The OCaml Cookbook is a place where OCaml developers share how to solve common tasks using packages from the ecosystem.
A task is something that needs to be done inside a project. A recipe is a code sample and explanations on how to perform a task using a combination of open source libraries.
The Cookbook now live at ocaml.org/cookbook, but there are not a lot of recipes published yet.
Here’s how we need your help:
- Help review open pull requests for cookbook recipes!
- Contribute new recipes and tasks for the cookbook!
- Suggest improvements to existing recipes and the UI.
Relevant PRs and Activities:
- Open PRs in need of reviewers:
- PR: Cookbook geodesic ocaml/ocaml.org#2381 by @F-Loyer
- PR: Cookbook / subprocess creation ocaml/ocaml.org#2382 by @F-Loyer
- PR: Cookbook getenv ocaml/ocaml.org#2383 by @F-Loyer
- PR: Cookbook : linalg ocaml/ocaml.org#2386 by @F-Loyer
- PR: Use camlzip and with_open_text ocaml/ocaml.org#2371 by @cuihtlauac
- PR: Deserialise and post-process YAML recipes ocaml/ocaml.org#2372 by @cuihtlauac
- PR: Rebased database recipes ocaml/ocaml.org#2376 by @cuihtlauac
- PR: Rebased basic concurrency recipe ocaml/ocaml.org#2377 by @cuihtlauac
- PR: Rebased sorting recipe ocaml/ocaml.org#2378 by @cuihtlauac
- PR: Rebased ascii and utf-8 recipes ocaml/ocaml.org#2379 by @cuihtlauac
Community & Marketing Pages Rework
We have UI designs for the reworked and new pages of the community section and are starting work to implement these. We are opening small issues for contributors to help.
Relevant PRs and Activities:
- PR: UI: Added DateTime of Event on the Client Side in the User’s Timezone ocaml/ocaml.org#2339 by @maha-sachin
- PR: Create new Events page with routing under Community ocaml/ocaml.org#2338 by @shakthimaan
- PR: Add event_type field to Events, and render tag in Event cards ocaml/ocaml.org#2366 by @csaltachin
General Improvements and Data Additions
Relevant PRs and Activities:
- Bugfixes
- PR: fix: add .modules style for odoc-generated documentation pages ocaml/ocaml.org#2355 by @sabine
- PR: Fix: correct text color on community resource card ocaml/ocaml.org#2329 by @sabine
- PR: fix: Make Community card about LearnOCaml point to the correct URL ocaml/ocaml.org#2331 by @yurug
- Documentation
- PR: OCaml Tour: -New sections- Introduction and Before We Begin. Added REPL definition and double semicolon use ocaml/ocaml.org#2336 by @Alfredo-Carlon
- PR: Minor line editing on “Values and Functions” Tutorial ocaml/ocaml.org#2321 by @jeuxdeau
- Data
- PR: [planet]: add melange blog ocaml/ocaml.org#2362 by @anmonteiro
- PR: (data) add april OUPS meetup ocaml/ocaml.org#2360 by @sabine
- PR: Add TUM as an academic institution ocaml/ocaml.org#2347 by @PumPum7
- PR: Add Routine job post. ocaml/ocaml.org#2325 by @mefyl
- PR: (data) Add OCaml Workshop to Upcoming Events ocaml/ocaml.org#2326 by @sabine
- PR: (data) add ReasonSTHLM meetup ocaml/ocaml.org#2308 by @sabine
- PR: Add missing Mdx changelogs ocaml/ocaml.org#2368 by @tmattio
- PR: Fix small typo in Dune 3.14 announcement ocaml/ocaml.org#2315 by @Leonidas-from-XIV
- PR: Dune 3.15.0 announcement ocaml/ocaml.org#2316 by @Leonidas-from-XIV
- PR: OCaml 5.2.0-beta2 changelog entry ocaml/ocaml.org#2343 by @Octachron
- PR: (data) add March 2024 OCaml.org newsletter ocaml/ocaml.org#2317 by @sabine
- PR: Add the announement for opam 2.2.0~beta2 ocaml/ocaml.org#2334 by @kit-ty-kate
- PR: jobs: remove XenServer positions ocaml/ocaml.org#2387 by @edwintorok
- Move of the OCaml Language Manual from v2.ocaml.org to ocaml.org
- PR: fix: Serve manual under /lts and /latest URLs ocaml/ocaml.org#2345 by @sabine
- PR: Remove /manual/lts URL, fix broken route for /manual/latest ocaml/ocaml.org#2348 by @sabine
- PR: Add /api/** redirection ocaml/ocaml.org#2352 by @mtelvers
- PR: Handle lts, default and missing version in middleware ocaml/ocaml.org#2358 by @cuihtlauac
- PR: Add served pages to sitemap ocaml/ocaml.org#2363 by @cuihtlauac
- PR: Skip unreleased manuals from sitemap ocaml/ocaml.org#2367 by @cuihtlauac
- PR: Turn some v2 redirects into local ocaml/ocaml.org#2356 by @cuihtlauac
- Refactor / Code health
- PR: Remove Commit module from Global ocaml/ocaml.org#2319 by @cuihtlauac (created/merged: 2024-04-05T14:17:31Z)
- PR: chore: remove learn_sidebar.eml, which was not used anymore ocaml/ocaml.org#2342 by @sabine
- PR: Add link to deploy.ci.ocaml.org in HACKING ocaml/ocaml.org#2354 by @cuihtlauac
- PR: Use type annotation for data parameters ocaml/ocaml.org#2384 by @cuihtlauac