返回新闻

OCaml.org 新闻通讯：2023 年 11 月 + 12 月

欢迎来到 2023 年 11 月和 12 月版的 OCaml.org 新闻通讯！此更新由 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 月份完成了学习区域浅色模式新设计的实施工作！

相关 PR 和活动

2. OCaml 文档

11 月份，我们专注于解决和整合社区对“入门”文档的反馈。Discuss 上的评论和讨论非常有帮助。我们鼓励更多这样的讨论！

我们还致力于完善“基本数据类型”和“值与函数”。此外，团队一直在编写新的“模块”、“函子”和“使用 Dune 的库”文档，希望在年底之前完成这些文档以及社区审核中的文档（如下）。

相关 PR 和活动

我们开始打开标记为“需要帮助”的问题，以使外部贡献者能够帮助改进文档。反应非常积极，我们很高兴继续这样做，并借助您的帮助，使 OCaml 文档真正出色！

即将推出的深色模式

12 月份，oyenuga17 开始在 OCaml.org 上实施新的深色模式。计划是根据浏览器/操作系统首选项在 3 月初完成并激活深色模式。

我们不断将小补丁合并到 ocaml.org，您可以在 https://staging.ocaml.org 上查看已完成的深色模式页面。我们在页面底部放置了一个按钮，用于在暂存环境中切换深色模式（这不会发布，它只是我们审查深色模式页面的方法）。

相关活动和 PR

  • 在学习区域着陆页上实现深色模式 - ocaml/ocaml.org#1836
  • 所有 OCaml.org 页面深色模式的 UI 设计，以及由此产生的设计系统更改

宣布 Outreachy 实习生

11 月，我们审核并评估了深色模式项目和 GUI 项目的 Outreachy 贡献，并选出了两名实习生。@oyenuga17 将与 OCaml.org 团队合作实现深色模式，而 @IdaraNabuk 被选中负责 GUI 项目。祝贺 @IdaraNabuk 和 @oyenuga17！

由于 Outreachy 申请期已于 10 月结束，我们在下面的“通用改进”部分列出了所有在 Outreachy Issues 上完成的剩余拉取请求。

通用改进

最重要的更改 TLDR:

  • 现在 OCaml.org 有一个自托管的 Plausible.io 实例，可通过 https://plausible.ci.dev/ocaml.org 访问！
  • 您可以在新的治理页面 https://ocaml.org.cn/governance 上查看不同的 OCaml 团队（编译器、平台、打包、基础设施、OCaml.org）以及相关存储库的维护者！
  • OCaml 徽标现在在 https://ocaml.org.cn/logo 上有一个专门的页面！
  • 我们现在在软件包概述页面上显示软件包的 README。
  • 您现在可以在 https://ocaml.org.cn/community 上 列出即将举行的活动，包括日期和时间。
  • OCaml.org 现在有社交媒体图片，这样分享 OCaml.org 链接看起来更漂亮。

衷心感谢 11 月和 12 月帮助改进 OCaml.org 的众多贡献者。请在下面找到他们的名单！

相关 PR 和活动