OCaml.org 電子報:2023 年 11 月 + 12 月

歡迎來到 OCaml.org 電子報 2023 年 11 月和 12 月的內容!此更新由 OCaml.org 團隊彙編。您可以在 Discuss 上找到先前的更新

我們的目標是讓 OCaml.org 成為任何想要開始並在 OCaml 中高效工作的人的最佳資源。OCaml.org 電子報提供了我們朝著該目標邁進的進度更新,以及我們正在進行的變更概述。

如果沒有所有優秀的 OCaml 社群成員的幫助,我們無法做到這一切,他們幫助我們審查、修改並建立更好的 OCaml 文件。您的回饋使我們能夠更好地確定工作的優先順序,並朝著我們的目標邁進。謝謝!

本電子報涵蓋

  • 學習區:我們對學習區 UI 進行了重大變更,引入了一個新的登陸頁面,並改進了學習區子頁面上的各種元素。文件搜尋功能的工作正在進行中,並且已經新增或大幅改進了新的文件!
  • 即將推出的黑暗模式:我們完成了即將推出的黑暗模式的 UI 設計,而我們的 Outreachy 實習生已經開始實作這些變更。
  • 宣布 Outreachy 實習生:我們很高興歡迎兩位實習生參與 OCaml 專案!
  • 一般改進:與往常一樣,我們也根據使用者回饋進行了一般維護和改進,因此我們將重點介紹以下部分工作。

給貢獻者的開放議題

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

您可以在這裡找到給貢獻者的開放議題

學習區

1. 學習區的重新設計

OCaml.org 正在進行一項令人興奮的轉型,我們很高興與您分享一些重要的更新。我們的主要重點是最終確定並批准新的使用者介面 (UI) 設計,旨在增強您的體驗。此更新不僅僅關乎外觀;我們正在確保網站完全針對行動裝置和平板電腦進行最佳化。

我們的團隊和像您這樣的使用者之間的合作在塑造專案方面發揮了重要作用。您的投入和支持是無價的,我們很感謝社群參與讓這個網站變得更好。

我們的設計系統進行了一些更新,包括新的元件(如可變的登陸頁面按鈕)、各種圖示(包括社群媒體和 OCaml 圖示,如 Dune 和 opam)、增強的文字樣式、更新的顏色變數等等。

我們已經完成了學習區所有頁面的設計。每個頁面的設計都注重細節,確保所有版本的一致性和連貫性。

如果您感到好奇並想仔細查看設計,您可以存取我們的Figma 設計檔案。請注意,頁面上顯示的內容並不總是準確的。我們的目標是為我們的設計師提供更好的內容,以便未來進行模型建立和 UI 設計。

12 月,已完成學習區淺色模式的新設計實作工作!

相關的提取請求和活動

2. OCaml 文件

11 月,我們專注於解決和納入社群對「開始使用」文件的回饋。Discuss 上的評論和討論非常有用。我們鼓勵更多這樣的行為!

我們還致力於潤飾「基本資料類型」和「值和函式」。此外,團隊一直在開發新的「模組」、「函式器」和「使用 Dune 的程式庫」文件,希望能在年底前發布這些文件以及社群審查中的文件(如下所示)。

相關的提取請求和活動

我們開始開啟標記為「需要協助」的議題,以便外部貢獻者幫助改進文件。回應非常積極,我們很高興繼續努力,在您的幫助下讓 OCaml 文件真正變得出色!

即將推出的黑暗模式

12 月,oyenuga17 開始在 OCaml.org 上實作新的黑暗模式。計劃在 3 月初完成並根據瀏覽器/作業系統偏好設定啟動黑暗模式。

我們不斷將小型修補程式合併到 ocaml.org 中,您可以在 https://staging.ocaml.org 上查看已完成的黑暗模式頁面。我們在頁面底部放置了一個按鈕,以切換測試環境上的黑暗模式(這不會發布,這只是我們審查黑暗模式頁面的一種方式)。

相關活動和提取請求

  • 在學習區登陸頁面上實作黑暗模式 - ocaml/ocaml.org#1836
  • 所有 OCaml.org 頁面的黑暗模式 UI 設計,以及由此產生的設計系統變更

宣布 Outreachy 實習生

11 月,我們審查並評分了黑暗模式專案和 GUI 專案的 Outreachy 貢獻,並選出了兩位實習生。@oyenuga17 正在與 OCaml.org 團隊合作實作黑暗模式,而 @IdaraNabuk 則入選了 GUI 專案。恭喜 @IdaraNabuk@oyenuga17

由於 Outreachy 申請期於 10 月結束,我們將所有在「一般改進」章節中 Outreachy 議題上完成的剩餘提取請求列出。

一般改進

最重要變更的 TLDR:

  • 現在有一個適用於 OCaml.org 的自我託管 Plausible.io 執行個體,可透過 https://plausible.ci.dev/ocaml.org 存取!
  • 您可以在新的治理頁面 https://ocaml.dev.org.tw/governance 上查看不同的 OCaml 團隊(編譯器、平台、封裝、基礎架構、OCaml.org)和相關存放庫的維護者!
  • OCaml 標誌現在有了專屬頁面,網址是 https://ocaml.dev.org.tw/logo!
  • 我們現在會在套件總覽頁面顯示套件的 README。
  • 您現在可以在 https://ocaml.dev.org.tw/community 上列出即將舉辦的活動,包含日期和時間。
  • OCaml.org 現在有了社群媒體圖片,讓分享 OCaml.org 連結時看起來更美觀。

非常感謝眾多貢獻者在 11 月和 12 月協助改進 OCaml.org。以下列出他們的貢獻!

相關的提取請求和活動