OCaml.org 電子報:2023 年 8 月 & 9 月
歡迎來到 OCaml.org 電子報 2023 年 8 月和 9 月的版本!本次更新由 OCaml.org 團隊彙編。您可以在 Discuss 上找到先前的更新。
我們的目標是讓 OCaml.org 成為任何想要開始使用 OCaml 並提高生產力的人的最佳資源。OCaml.org 電子報提供我們朝著該目標邁進的進度更新,以及我們正在進行的變更概述。
如果沒有所有協助我們審閱、修改和建立更好的 OCaml 文件之優秀 OCaml 社群成員,我們就無法做到這一點。您的回饋使我們能夠更好地確定工作優先順序,並朝著我們的目標邁進。謝謝!
過去兩個月,我們的優先事項是
- 學習區塊:我們正努力使 OCaml.org 成為學習 OCaml 和探索其生態系統的絕佳資源。我們專注於讓新的「開始使用」文件準備好發佈,並且我們開始著手學習區塊的第二版設計。
- 一般改進:與往常一樣,我們還根據使用者回饋進行了一般維護和改進,因此我們將重點介紹以下一些工作。
學習區塊
1. 重新設計學習區塊
在 7 月完成第一版設計後,我們開始著手新一版的設計,使其更符合網站目前的品牌形象。團隊和使用者的回饋對於使用者體驗(新文件的結構和頁面佈局)非常正面,但我們認為設計方向需要與所有頁面的現有設計相協調並加以改進。因此,我們正在重新審視淺色和深色模式下的設計使用者介面方面。
相關的 PR 和活動
- 持續開發新學習區塊的 Figma UX/UI 設計
- 持續進行整體學習區塊的使用者介面設計
- 改進行動裝置上首頁的深色模式,並進行必要的文字修改
- 設計具有開啟導航功能和麵包屑導航的搜尋欄位行動檢視
- 致力於更新設計系統,以確保淺色和深色變體之間的一致性
- 繼續實作學習區塊的新元件
- 學習區塊的技能標籤元件已完成 -- ocaml/ocaml.org#1427
- 學習總覽卡片(安裝 + 標準函式庫 API)已完成 -- ocaml/ocaml.org#1441
- 書籍區塊元件已完成 -- ocaml/ocaml.org#1481
- 教學課程區塊元件已完成 -- ocaml/ocaml.org#1387
- 練習區塊元件 -- ocaml/ocaml.org#1479
- 影片區塊元件 -- ocaml/ocaml.org#1480
- 語言手冊橫幅元件 - ocaml/ocaml.org#1406
- 變更學習區塊標籤導覽顏色 - ocaml/ocaml.org#1522
2. OCaml 文件
自 8 月以來,我們主要專注於「開始使用」文件,包括 OCaml 安裝指南、OCaml 語言「導覽」,以及建立您的第一個 OCaml 專案的教學課程。
為了迎接 10 月的更新,我們剛剛發佈了新的「開始使用」文件頁面!:tada
我們仍然鼓勵社群回饋,因為我們完全希望在接下來的幾週內逐步改進這些文件,尤其是在它們現在將成為每個想要開始使用 OCaml 的人的主要資源時。
我們現在的重點將轉移到填補文件「語言」部分的空白,從「基本資料類型」和「函式與值」頁面開始,這些頁面目前處於社群審閱階段。
相關的 PR 和活動
- 第一版草稿進行中
- 集合
- 對應
- 可變狀態 / 命令式程式設計
- 審閱中(內部)
- 多型變體
- 審閱中(社群)
- 基本資料類型(請參閱 Discuss 討論串)
- 函式與值(請參閱 Discuss 討論串)
- 檔案操作(請參閱 Discuss 討論串)
- 已發佈
- 安裝 OCaml(請參閱 Discuss 討論串)
- OCaml 導覽(請參閱 Discuss 討論串)
- 您的第一個 OCaml 程式(請參閱 Discuss 討論串)
- opam 交換器簡介
- 修正 Apple M1 上的 Homebrew 錯誤
- 運算子
- 錯誤處理(請參閱 Discuss 討論串)
- 陣列(請參閱 Discuss 討論串)
- 序列(請參閱 Discuss 討論串)
一般改進
本月,我們歡迎 2 位新貢獻者
- @ShalokShalom 改進了「為什麼選擇 OCaml?」頁面 - ocaml/ocaml.org#1516
- @echuber2 修正了編輯器設定說明中損壞的連結 - ocaml/ocaml.org#1552
並歡迎回歸貢獻者的貢獻
- @AshineFoster 修正了網誌新聞區塊的日期剖析錯誤 -- ocaml/ocaml.org#1503
- @edwintorok 更新了職位佈告欄和產業用戶上的 XenServer 項目 -- ocaml/ocaml.org#1511
非常感謝本月的所有貢獻者!很高興看到越來越多人為網站做出貢獻!
相關的 PR 和活動
- OCaml.org 上的本地網誌(目前只有 opam 網誌)現在有專用的 RSS 摘要 -- ocaml/ocaml.org#1459
- 新增了OCaml 適合用於網站嗎?頁面 - ocaml/ocaml.org#1226
- 在 17 個不同的檔案中修復了可能損壞的連結 -- ocaml/ocaml.org#1461、ocaml/ocaml.org#1515 和 ocaml/ocaml.org#1520
- 變更 Playground 的 Makefile 以建立本機 opam 交換器(與 OCaml.org 的 Makefile 建立的本機交換器一致),以解決複製
Stdlib
建置成品的問題 -- ocaml/ocaml.org#1469 - 已將一篇 Outreachy 網誌文章的連結貢獻給 OCaml 星球 -- ocaml/ocaml.org#1474
- 修正了 Safari 上套件搜尋的問題 -- ocaml/ocaml.org#1510
- 以主要顏色反白顯示作用中連結,並增加行動裝置主導覽中連結的可點擊區域 - ocaml/ocaml.org#1521
- 對文件產生進行了小幅改進。
.md
檔案中的單個新行由 voodoo 轉換為換行符號。現在,voodoo 會為這些發出空格字元 -- ocaml-doc/voodoo#119 - 減少套件文件中
.spec
和.spec-doc
之間的間距 -- ocaml/ocaml.org#1509