返回新聞

OCaml.org 電子報：2024 年 1 月號

歡迎來到 OCaml.org 電子報 2024 年 1 月號！本次更新由 OCaml.org 團隊彙編。您可以在 Discuss 上找到先前的更新。

我們的目標是讓 OCaml.org 成為任何想要開始使用 OCaml 並提高生產力的人的最佳資源。OCaml.org 電子報提供我們朝此目標邁進的進度更新，以及我們正在進行的變更概述。

如果沒有所有令人驚嘆的 OCaml 社群成員協助我們審閱、修改和建立更好的 OCaml 文件，我們將無法做到這一點。您的回饋使我們能夠更好地確定工作的優先順序。謝謝！

本電子報涵蓋

  • OCaml 文件： 已發布新的文件，並且現有文件已得到改進。
  • 深色模式： 在實作即將推出的深色模式方面取得了良好進展。
  • 一般改進： 像往常一樣，我們也根據使用者回饋進行了一般維護和改進，因此我們將在下方重點介紹我們的一些工作。

開放給貢獻者的議題

我們為外部貢獻者建立了許多議題。它們中的大多數都適合 OCaml 初學者，我們很樂意審閱您的提取請求並提供回饋！

您可以在此處找到開放給貢獻者的議題！

OCaml 文件

我們發布了多個新文件，最值得注意的是關於模組、函子、Dune 函式庫，以及關於使用 OCaml.org Playground 的新教學。標記參數、集合和選項的文件已得到改進。

為了更好地了解新文件的效果，我們正在執行使用者測試（在 Discuss 和 Twitter/X 上宣布），以比較 v2.ocaml.org 上的舊文件內容與 ocaml.org 上的新文件。有足夠多的 OCaml 新手自願幫助我們完成這項工作。非常感謝！

此外，還有一份開放式調查，要求您根據舊內容對新文件進行評分：我們很樂意聽取您對這項調查的意見，即使您只給我們一些數字評分！

相關的 PR 和活動

我們開始開啟標記為「help wanted」的議題，讓外部貢獻者能夠協助改進文件。反應非常正面，我們很高興繼續這樣做，並在您的幫助下讓 OCaml 文件真正出色！

即將推出的深色模式

在 12 月，oyenuga17 開始在 OCaml.org 上實作新的深色模式。計畫在 3 月初完成並根據瀏覽器/作業系統偏好啟用深色模式。看來我們正按計畫進行。

我們不斷將小型修補程式合併到 OCaml.org 中，您可以在 https://staging.ocaml.org 上查看已完成的深色模式頁面。我們在頁面底部放置了一個按鈕，以切換暫存上的深色模式。（這不會發布。這僅是我們審閱深色模式頁面的方式。）

已完成的頁面

一般改進

最值得注意的變更 TLDR:

  • 我們合併了一個基本的文件搜尋功能，以便在 OCaml 文件中進行搜尋。它在「學習」區域「概觀」頁面上提供！這裡有改進的空間，其中最值得注意的是新增錯字更正，以及統一頂部導覽列搜尋框中的套件和文件搜尋。
  • 已修正套件文件模組樹狀檢視中顯示錯誤函式庫名稱的長期錯誤！
  • 套件概觀頁面現在連結到一個新頁面，其中列出所有套件版本及其發布日期。
  • 現在可以從主要登陸頁面存取變更日誌。
  • 我們現在會在教學 Markdown 頁面的 YAML 元資料中連結教學的先決條件和建議的下一個教學。這可確保教學之間的這些連結保持有效。

非常感謝許多在 1 月份協助改進 OCaml.org 的貢獻者。在下方列出他們的名字！

相關的 PR 和活動