OCaml.org 新闻简报:2024 年 3 月
欢迎来到 2024 年 3 月的 OCaml.org 新闻简报!此更新由 OCaml.org 团队编制。您可以在 Discuss 上找到 之前的更新。
我们的目标是使 OCaml.org 成为任何希望开始使用 OCaml 并提高生产力的人的最佳资源。OCaml.org 新闻简报提供我们朝着该目标取得的进展的更新,以及我们正在进行的更改概述。
没有所有帮助我们审查、修改和创建更好 OCaml 文档的优秀 OCaml 社区成员,我们无法做到这一点。您的反馈使我们能够更好地优先考虑我们的工作。谢谢!
本新闻简报涵盖
- OCaml 食谱:OCaml 食谱的原型,它提供简短的代码示例,这些示例使用 OCaml 生态系统中的包解决实际问题,位于 staging.ocaml.org/cookbook。
- 暗黑模式:我们根据您的操作系统/浏览器设置在 OCaml.org 的所有页面上启用了暗黑模式。
- 社区和营销页面重做:我们正在征求对社区部分和与营销相关的页面的线框的反馈。
- 一般改进:像往常一样,我们还根据用户反馈进行了一般维护和改进,因此我们将在下面重点介绍一些我们的工作。
贡献者开放问题
您可以在 此处找到贡献者开放问题!
即将推出的 OCaml 食谱
我们正在为学习区域添加一个社区驱动的部分:OCaml 食谱。此食谱被设计为食谱的集合,提供用于解决使用 OCaml 生态系统中的包来完成现实世界任务的代码示例。这是一个务实的努力,旨在丰富我们的学习资源,使它们对我们的社区更有用和有用。
本月,我们的重点转向完成食谱以供发布。这包括
- 重构目录结构和食谱文件的放置,以及
- 向食谱添加任务,以便您可以为这些任务贡献食谱(我们从优秀的 Rust 食谱 中汲取了灵感)。
始终可以为 OCaml 食谱提出更多任务。这里的主要标准是
- 任务需要不止一个标准库函数调用才能解决,
- 任务必须专注于在尝试构建产品时遇到的常见问题,
- 如果有疑问,请使任务更具体,而不是更通用。
一个很好的地方是 这个讨论主题,您可以对食谱提供反馈。
相关 PR 和活动
- (WIP) 食谱压缩/解压缩 by @F-Loyer
- 食谱:修复 Lwt 中的错误(类型与 iter_s/iter_p 函数不匹配) by @F-Loyer
- 更新 00-caqti-ppx-rapper.ml - 修复 caqti-driver-sqlite -> caqti-driver-sqlite3 by @F-Loyer
暗黑模式发布
我们很高兴宣布 OCaml.org 的暗黑模式已经发布。暗黑模式根据您的操作系统/浏览器设置激活。如果您看到任何错误,请打开一个问题并包含您看到问题的 URL。
相关 PR 和活动
- 在 Discuss 上宣布暗黑模式
- 为包文档添加初步的暗黑模式 by @sabine
- 修复:蓝色背景上的深色文本颜色 by @amarachigoodness74
- (暗黑模式) 调整面包屑文本颜色 by @sabine
- (ui) 激活暗黑模式 by @sabine
- 在“Is OCaml Web”页面上正确反转文本 by @SquidDev
- 修复:为包内搜索结果添加缺少的暗黑模式样式 by @sabine
- 删除旧的尾风颜色和样式,整理暗黑模式颜色 by @sabine
主页和营销页面重做
主页项目始于对用户调查和访谈的分析,以及主页和“工业用户”和“学术用户”页面的初始线框的开发。
我们一直在 在 Discuss 和 Twitter 上联系社区,以了解人们对 OCaml 的看法,以便我们可以在“学术用户”页面上通过推荐信提供更多上下文。
除此之外,我们还在 在 Twitter 上询问主页的主要标语的想法
您可以在 Figma 上评论线框 此处。
如果您对主页有任何意见,请随时在 这个讨论主题 中分享!
社区部分重做
本周,我们专注于为活动、工作、实习和研讨会页面创建线框,然后通过 Discuss 征求社区反馈。同时,开始进行社区登录页面以及活动和工作页面的 UI 设计工作。
我们还对社区页面上的活动部分进行了一些改进。这包括更好地处理活动开始/结束时间,以及列出更多即将举行的活动。
如果您对社区部分有任何意见,请随时在 这个讨论主题 中分享!
相关 PR 和活动
- 邀请人们将活动添加到活动目录中:https://discuss.ocaml.org/t/add-your-ocaml-events-to-the-community-page-on-ocaml-org/14251
- 改进活动目录 by @sabine
- 修复即将举行的活动列表中的模板错误 by @sabine
- 明确即将举行的活动时间是 UTC by @sabine
- 贡献给活动的数据
- (数据) 添加 S-REPLS 活动 by @sabine
- (数据) 修复活动上的错误日期 by @sabine
- (数据) 添加 OCaml Retreat Auroville by @D8kTwoXfSUWLdpXruFrQiw
- (数据) 添加 OCaml 马尼拉聚会 by @sabine
Outreachy 申请期和实习
3 月,OCaml.org 主办了一次 Outreachy 实习 申请期,内容是创建一个交互式体验,用于解决 OCaml 练习。
选择 Outreachy 实习生的过程包括创建和管理 15 个问题,审查来自 8 名申请人的 61 个拉取请求。这些任务在本质上是相似的,并且涉及重新构建练习以启用交互式体验,添加测试用例和解决方案(如果缺少)。
相关 PR 和活动
- 创建 practice 文件夹 by @cuihtlauac
- 在发出模板之前按 slug 对练习进行排序 by @csaltachin
- 将练习转变为实践 @Ozyugoo、@mnaibei、@divyankachaudhari、@Kxrishx03、@maha-sachin、@MissJae、@jahielkomu、@Appleeyes
一般改进和数据添加
相关 PR 和活动
- (WIP) 我们正在将 OCaml 语言手册从 v2.ocaml.org 移动到 ocaml.org
- 设置 dlvr.it 以自动将 OCaml 星球和 OCaml 变更日志的 RSS 提要项目发布到新的 ocaml_org Twitter 帐户
- 链接到 watch.ocaml.org 上最近添加的视频 by @sabine
- 将 Twitter 帐户从 OCamlLang 更改为 ocaml_org by @sabine
- 修复:news.eml 的小改进 by @sabine
- 仍然是类别 slug by @cuihtlauac
- 在碳足迹页面添加来自绿色网络基金会的徽章 by @0xrotense
- 将 odoc 2.4.1 部署到包文档管道
- 与 odoc.2.4.1 兼容 by @gpetiot
- 针对 voodoo/odoc 2.4.1 升级的补丁 by @sabine
- chore:在 voodoo 升级后将 doc url 设置为 live by @sabine
- 数据
- (数据) 添加 OCaml.org 新闻简报 2 月 by @sabine
- OCaml 4.14.2~rc1 的变更日志条目 by @Octachron
- 添加 dune.3.14.2 发布公告 by @Leonidas-from-XIV
- OCaml 4.14.2 发布和变更日志页面 by @Octachron
- OCaml 4.14.2:修复发布年份 by @edwintorok
- 添加 2024 年 2 月的平台变更日志 by @tmattio
- OCaml 5.2.0~beta1 的变更日志条目 by @Octachron
- 添加 2023 年冬季 Outreachy 轮次 by @patricoferris
- 文档
- 文档:关于 windows ppx_show 的说明 by @heathhenley
- (文档) 修复小错误 by @kenranunderscore
- (文档) 添加 Array 实例的链接 by @rmeis06
- 将练习链接到教程 by @rmeis06
- 解释为什么 t-first 可以与标签一起使用 by @mikhailazaryan
- 记录 begin ... end 使用 by @rmeis06
- 使用统一的语法进行 eval 步骤 by @cuihtlauac
- 将对原子模块的提及链接到文档 by @rmeis06
- 链接 Bigarray 引用 by @rmeis06
- (文档) 修复“带有 Dune 的库”中的示例 by @0xRamsi
- 修复 4ad_01_operators.md 中的错别字 by @vog
- (文档) 使用 DkML 2.1.0 by @jonahbeckford