OCaml.org 新闻通讯:2023 年 8 月 & 9 月
欢迎阅读 2023 年 8 月和 9 月版的 OCaml.org 新闻通讯!此更新由 OCaml.org 团队整理。您可以在 Discuss 上找到以前的更新。
我们的目标是将 OCaml.org 打造成为任何想要入门并提高 OCaml 效率的最佳资源。OCaml.org 新闻通讯提供了我们朝着这一目标取得的进展的更新,以及我们正在进行的更改概述。
如果没有所有帮助我们审查、修改和创建更优质的 OCaml 文档的优秀 OCaml 社区成员,我们无法做到这一点。您的反馈使我们能够更好地确定工作优先级,并在实现目标方面取得进展。谢谢!
在过去的两个月里,我们的工作重点是
- 学习区域:我们正在努力将 OCaml.org 打造成为学习 OCaml 和探索其生态系统的绝佳资源。我们专注于准备新的“入门”文档以供发布,并开始着手对学习区域的设计进行第二次迭代。
- 常规改进:像往常一样,我们还根据用户反馈进行了常规维护和改进,因此我们将在下面重点介绍我们的一些工作。
学习区域
1. 学习区域的重新设计
在 7 月完成第一版设计后,我们开始着手进行新的迭代,使其更符合网站当前的品牌形象。团队和用户对 UX(新文档的结构和页面的布局)的反馈非常积极,但我们觉得设计方向需要与所有页面的现有设计相协调并进行改进。因此,我们正在重新审视浅色和深色模式下设计的 UI 方面。
相关 PR 和活动
- 继续进行新的学习区域的 Figma UX/UI 设计 工作
- 继续进行学习区域的整体 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 线程)
常规改进
本月,我们欢迎两位新的贡献者
- @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 Feed -- ocaml/ocaml.org#1459
- 添加了一个 OCaml 是否已成为 Web 语言? 页面 - 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 Planet -- 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