建议:更新现场指南

该提案来自于WordPress社区峰会特别会议。本次会议源于在会议期间关于向后兼容性的讨论古腾堡古腾堡 古腾堡项目是WordPress的新编辑器界面。编辑器改进了创建新内容的过程和体验,使编写丰富内容变得更加简单。它使用“块”来增加丰富性,而不是短代码、自定义HTML等。https://wordpress.org/gutenberg网站/在这里,我们注意到WordPress和WordPres站点构建器的扩展程序很容易忽略WordPress的一些更改。

背景

WordPress中的字段指南始于3.4,自WordPress4.1以来一直在发布。在这段时间里,由于开发说明开发说明 WordPress Core中的每个重要更改都记录在开发人员备注中(通常称为开发备注)。好的开发注释通常包括对更改的描述、导致此更改的决策,以及对开发人员应该如何处理此更改的描述。在WordPress发布周期的测试阶段,开发人员的笔记会发布在Make/Core博客上。当插件/主题作者和WordPress开发人员需要了解这些更改时,发布开发注释尤其重要。一般来说,所有开发注释都在候选发布阶段的开始时编译到Field Guide中。以及每个版本中的更改数量。

较长的帖子可能更难读完,这可能会导致重要信息被遗漏。此外,由于许多信息都与帖子相关,而不是包含在帖子中,因此需要努力真正了解WordPress版本中变化的广度。所有发布的信息对WordPress社区来说都是有价值的,因此阻止内容的发布与通知和帮助WordPres社区的目标是背道而驰的,这不是我们想要的。

建议书

本提案的第一部分是继续发布现有的现场指南现场指南 现场指南是在WordPress发布周期。现场指南通常列出测试周期内发布的所有开发说明。本指南链接在WordPress相应版本的about页面、发布文章和HelpHub版本页面中。在此站点上(使/核心核心 Core是运行WordPress所需的一组软件。核心开发团队构建WordPress。)但要调整发布目标到最终计划贝塔贝塔 一种预先发布的软件,分发给大量用户在真实条件下进行试用。Beta版已经在内部进行了alpha测试,在外观、感觉和功能上与最终产品相当接近;然而,设计更改经常作为过程的一部分发生。目前,目标是与RC1同时发布《现场指南》。这并没有改变发布团队的工作量,但它确实将目标提高了大约一周。早些时候发布这篇文章将给一些额外的时间来更新文档,鼓励社区进行测试,也有时间为本提案的第二部分做准备。

第二部分是开始向WordPress开发者博客。本指南的受众主要是两组:WordPress的扩展器,例如插件插件 插件是一个包含一组功能的软件,可以添加到WordPress网站。他们可以扩展功能或为WordPress网站添加新功能。WordPress插件是用PHP编程语言编写的,并与WordPres无缝集成。这些可以在WordPress.org插件目录中免费https://wordpress.org/插件/或者可以是第三方基于成本的插件以及主题作者和开发人员构建自定义站点。本简化指南将重点介绍以下内容:

  • 开发人员希望加入的大型功能
  • 极有可能导致破损的变化
  • 核心团队希望开发人员立即开始使用功能,因为使用这些功能将使WordPress最终用户受益。

例如,WordPress 6.3的超聚焦现场指南本可以突出显示新的命令平台(开发人员希望加入的一个大功能)、脚本加载器中的异步/延迟(当开发人员开始使用时,WordPrins最终用户将受益的一个新功能),而post编辑器被iframed(一个可能导致破坏的更改)。

本《现场指南》的目标长度应为800-1000字,并且应链接但不嵌入任何其他文档,如开发说明。目标是在RC1发布后的一周内发布此帖子。开发人员上发布的所有内容都采用相同的流程博客博客 (与网络、站点相比)发布文档负责人或其指定人员将与WordPress开发人员博客团队合作#堆芯-dev-blog通道和开发人员博客内容GitHub存储库以协调内容和发布日期。

2023年9月15日前提供反馈

这项提议只是一步,但不一定是唯一的一步,目的是改善WordPress版本的沟通,使WordPres更新更容易灌输信心。2023年9月15日前接受反馈

多亏了@安娜扎祖,@网络通信卫星,@恩迪戈、和@杰夫保罗在发布之前获取有关此建议的反馈。