库管理 编辑

程序包名称

官员的文件包名称wp-cli公司 githubgithub GitHub是一个提供git存储库在线实现的网站,其他开发人员可以轻松共享、复制和修改这些存储库。公共存储库可以免费托管,私有存储库需要付费订阅。GitHub引入了“拉请求”的概念,在将贡献者在分支中所做的代码更改合并为存储库所有者之前,可以对其进行审查和讨论。https://github.com/组织需要提前与维护人员

在创建新的存储库之前,首先讨论存储库是很重要的。此讨论有助于就代码库的用途以及它在WP-CLI公司WP-CLI公司 WP-CLI是WordPress的命令行界面,用于以编程方式执行管理和开发任务。项目页面是http://wp-cli.org/ https://make.wordpress.org/cli/生态系统。

WP-CLI命令的包名称必须以-命令后缀以保持清晰,并将其与非命令存储库区分开来。

在为命令创建新的存储库之前,需要决定该命令是否应该拥有自己的存储库,或者是否应该将其包含在现有存储库中。

示例:wp-cli/scaffold-package命令

顶部↑

程序包版本

软件包版本遵循语义版本规范(SemVer)

用外行的话来说,这通常意味着:

  • 修补程序版本(例如1.0.x)用于错误修复、文档更改、小增强等。
  • 次要版本(例如1.x.0)在将新命令引入包或对现有命令进行重大增强时使用。
  • 主要版本当框架更改更改WP-CLI时使用(例如x.0.0)美国石油学会美国石油学会 API或应用程序编程接口是一种软件中介,允许程序相互交互并以有限的、明确定义的方式共享数据。以一种断裂的方式。

顶部↑

里程碑

打开的里程碑通常指向要发布的下一个版本。

由于发布说明是使用里程碑构建的,因此拉请求和要合并的问题都需要设置为即将到来的里程碑,以便这些拉请求将成为发布说明的一部分。

顶部↑

标签

标签是一种重要的组织工具,用于传达正在完成的工作的状态和进度。承诺人需要保持这些最新。

准确标记问题和拉取请求有助于我们理解问题跟踪器的总体使用情况,并更容易搜索已关闭的问题和拉入请求以进行过去的讨论。

顶部↑

标签组

标签可以是标签组的一部分,这是一个适用于所有包装的概念。可用的实际标签可能取决于实际的包,但组始终具有相同的语义角色。

顶部↑

命令

定义给定问题/请求应用于哪个确切命令的标签前缀为命令:

示例:命令:cli-update

顶部↑

范围

定义当前问题/请求适用范围的标签前缀为范围:

使用的范围:

  • 范围:引导–引导过程的一部分,加载WP-CLI和WordPress核心核心 核心是运行WordPress所需的一组软件。核心开发团队构建WordPress。
  • 范围:分发–分发过程的一部分,其中正在构建Phar并生成版本。
  • 范围:文档–手册、命令参考或内联帮助的一部分。
  • 范围:框架–WP-CLI框架本身的一部分,它提供了体系结构、API和帮助函数,使命令成为可能。
  • 范围:测试–单元或功能测试的一部分。
  • 范围:网站–网站基础设施的一部分wp-cli.org网站make.wordpress.org网站

顶部↑

定义给定问题/请求所处状态的标签前缀为状态:

已用状态:

  • 状态:未确认–问题中的错误/问题尚未复制,或者可能与记者的环境有关。
  • 状态:不支持–此问题超出了错误报告的范围,GitHub不支持此问题。记者应该指向其中一个支持渠道

顶部↑

命令

定义给定问题/请求与哪个特定命令相关的标签前缀为命令:

一些例子:

  • 命令:核心–与下的一个或多个子命令相关wp堆芯父命令。
  • 命令:cli-check-update–与wp-cli检查更新命令。
  • 命令:后元更新–与wp后元更新命令。

顶部↑

所需标签

一些标签具有特殊含义和/或可能用于自动化工作流。所有官方软件包都需要这些功能。

顶部↑

缺陷

这个缺陷label表示一个问题,它是一个已确认的错误,其中代码没有产生预期的结果。

Bug特定于现有功能的意外行为。被认为缺少的功能不是一个缺陷,而是一个增强。

顶部↑

上游Bug

这个上游错误标签表示上游软件(例如WordPress核心、,菲律宾比索菲律宾比索 PHP(PHP:Hypertext Preprocessor的递归缩写)是一种广泛使用的开源通用脚本语言,特别适合web开发,可以嵌入到HTML中。http://php.net/manual/en/intro-whatis.php等),在WP-CLI中不会修复。

顶部↑

好的第一期

这个好的第一期这个标签表示一个问题,对于希望了解情况的新贡献者来说,这是一个很好的切入点。

好的第一个问题范围很小,不需要广泛的技术专业知识或历史项目知识就可以开始。

顶部↑

提交

不对默认分支执行直接提交(主要的/主人)包的分支。所有代码更改都需要经过拉请求工作流。

顶部↑

Pull请求

所有代码更改都要经过拉请求工作流。

每个提交的拉取请求都需要经过代码审查,并且需要至少一个提交人

顶部↑

合并前提条件

非平凡的拉请求之前应该有一个相关的问题,它定义了要解决的问题,并允许在实际编写代码之前讨论最合适的解决方案。

如果拉取请求是由提交人,提交者应将该请求的“审阅者”设置为wp-cli/提交程序如果需要进行一般代码审查,或者如果需要特定人员的专业知识,则提交一个或多个特定的提交者概要。

如果拉入请求由外部参与者提交,则提交人应该做出回应,并提供快速反馈,以鼓励进一步的贡献。

顶部↑

不可合并捐款

有时,拉请求可能无法合并,无论对其应用了多少额外的工作(例如超出范围等)。在这种情况下,最好尽可能轻柔而坚定地让贡献者失望,以鼓励未来的参与,避免爆发火焰战争。

确保:

  1. 感谢贡献者的时间和努力。
  2. 充分解释决定结束拉取请求背后的理由。
  3. 链接到尽可能多的支持文档。

如果您希望使用模板:

感谢________为您在这个拉取请求上花费的时间。

我关闭此拉取请求是因为________。为了进一步澄清,________。

有关更多详细信息,请参阅________和________。

顶部↑

合并条件

除了需要获得批准外,拉请求还需要在合并之前使其测试处于通过状态。当这两个条件都满足时,任何提交者可以通过以下方式合并拉取请求:

  1. 确保已设置所有适用标签。
  2. 确保设置了正确的里程碑。
  3. 确保在合并后删除分支(如果适用)。
  4. 根据需要调整拉动请求的标题。理想的拉请求标题是可以复制并粘贴到发行说明中的标题。

一旦拉入请求被合并,提交人应确保所有相应的问题也已关闭并分配给正确的里程碑。

顶部↑

发布

顶部↑

WP-CLI发布

WP-CLI发布由维护人员

发布准备就绪后,将根据发布检查表由其中一个维护人员

顶部↑

软件包版本

软件包发布按需进行,由维护人员。当出现以下情况时,包装会被标记为发布:

  • 它有合理数量的更改,这些更改已经存在了一段时间(几周或更长时间),并将从夜间构建中受益。
  • 它有一个实质性的增强(例如一个新命令),值得进入夜间构建进行预发布验证。

如果有一个开放的拉取请求需要包含在发布中,那么标记发布应该推迟(几天到几天)。

包发布说明应包括每个合并的拉取请求的主题和链接。不需要包含次要的文档、编码标准和测试套件更改。为了清晰起见,可以随意编辑主题。请参见wp-cli/scaffold-command v1.0.6例如。

重要的是,标记软件包版本也是对产品质量进行最终审查的机会:

  • 每个合并的pull请求都很有意义,并且有足够的测试覆盖率和文档。
  • 该包的README.md是最新的。
  • 除非有明确的意图,否则没有引入突破性的更改。

标记新软件包版本后wp-make-coffe咖啡bot针对提交拉请求wp-cli/wp-cli结果是作曲家更新当合并此拉请求时,包版本将在WP-CLI夜间构建中结束。

顶部↑

提示和工具

顶部↑

GitHub搜索

有很多有用的方法可以搜索GitHub。这些搜索可以放入书签或作为链接嵌入页面。

以下是一些例子:

上次更新时间: