和他的 档团队成员出席年社区峰会

随着 Leo 越来越积极地参与文档贡献,他开始参加团队的每周会议。他不时自愿主持会议。他不断学习团队中的新任务,不断扩大自己的参与度,例如在WordCamp US 2023的贡献者日期间帮助将新贡献者纳入文档表。

“在贡献者日期间,坐在文档团队的桌子旁很有趣。除了能够与我通常只在 GitHub 和 Slack 上互动的人面对面工作外,还有很多饼干可以尝尝,”他说。

他提到的饼干是 Docs 团队在贡献者日的传统——Milana 会在活动期间带来各种饼干一起吃。“在 Docs 团队的 Slack 频道中,我们通常会通过发送饼干表情符号来表示称赞——这是称赞某人做得好的一种方式。因此,我们在贡献者日的餐桌上将其变为现实。当然,我们也会与其他团队分享它们,”Leo 说道。

为了回答个常见问题澄清说

一个人不必是技术专家才能为团队做出贡献。“有两种类型的文档:最终用户和开发人员。对于最终用户文档,如果您使用 WordPress 并了解其工作原理,您应该能够编写文档。它基本上是指导其他用户在平台内导航。但是,创建开发人员文档在一定程度上需要技术知识。”

担任文档团队成员
WordPress 文档团队的工作涉及的流程远不止编写指南。“文档团队旨在确保准确全面地解释每个功能。例如,以WordPress Blocks为例。在创建有关该功能的文档时,我们会解释它是什么,并详细说明如何使用它及其功能。如果有任何可用的视觉表示,我们会​​将它们包含在文档中,以便最终用户可以更好地理解它,”Leo 解释道。

以下是 Leo 通常要经历的撰写文档文章的流程:

仔细检查文档团队 GitHub 存储库,查找您想要 土耳其电话号码 处理的问题,然后将自己分配给该问题。
开始起草。您可以在 Google Docs 中执行此操作,或者如果您有访问权限,也可以直接在 WordPress 后端执行此操作。
在写作时,您可以测试该功能,但请务必参考解释该功能的 GitHub 票证。
草稿准备就绪后,审阅人员将介入,确保内容符合风格指南和格式要求。如有必要,他们还会进行编辑。
审核通过后,即可发布文档。

文档团队会定期更新现有文档

“在每个 WordPress 版本中,文档发布小组都会检查现有文档并查看必须进行哪些更新。这适用于最终用户和开发人员文档。”

然后他解释说,这些更新通常是在候选发布期间进行的。如果应用了微小的更改或发现了任何错误,也可能会在发布周期之外进行更新。

目前,WordPress 文档网站上的最终用户文档主要 还很欣赏管理文件和创建备份的简易性 分为四个类别:WordPress 概述、技术指南、支持指南和自定义。同时,开发人员文档则根据更具体的主题进行分类,例如代码参考、插件和块编辑器。

显示用户文档的 WordPress 文档 选择加入列表 网站主页
需要注意的是,开发者文档与开发者说明不同。开发者文档涵盖了 WordPress 更广泛的技术方面,例如最佳编码实践以及如何与各种 API 交互。同时,开发者说明包含和他的 档团队成员 即将发布的 WordPress 版本中的技术更改的详细信息,以及开发者需要了解的有关这些更改的信息。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部