RubyGems 导航菜单

博客

返回博客文章

移除编辑链接集表单

假设你已为你的宝石构建了一个未来感十足的网站,现在你希望在我们网站上更新它的主页链接。链接集编辑链接发生了什么事?当你发现编辑链接已经不复存在(按 F 键表示悲痛)时,你可能会发现自己正在问这个问题。在你开始更多地 质疑自己的理智 之前,我们向你保证,你仍生活在你一直生活在时间线中。虽然我们还没有传送门,但你现在可以按版本设置宝石页面侧边栏链接,这总归是件好事。

它始于 @fwolfst 建议,我们应该使用 gemspec 来设置源代码链接,而我们对此的全部回应是

提交一个应用此更改和测试的 Pull Request,这样才能获得审核。

花 4 年时间交付一个功能听起来既不激动人心,也不令人印象深刻,直到你了解为实现它我们必须润滑的齿轮。我们 公开了 API 的元数据字段, Bandwagon 添加了链接集和变更日志的 URL,回填了较旧版本的元数据,甚至 还原 了提交的一次还原。在处理其他紧迫问题时,@kbrock 持续更新 他的 PR,这真是太好了。就目前的情况而言,如果你需要更新以前通过 UI 编辑的任何侧边栏链接,则需要在 spec.metadata 中设置几个 URI 属性。请查看我们的 指南,了解要求的详细信息。

immutable

版本页面上,我们预计依赖关系、必需的 Ruby 版本和 SHA256 校验和等字段全都针对我们查看的版本。页面上我们看到的大多数内容始终来自 gemspec 文件的各种属性。值得注意的例外情况是右侧边栏上显示的维基、代码、邮件、问题跟踪器和文档链接。您过去可以使用编辑linkset窗体和模型belongs_torubygems(非 versions)来选择将其设置为它们。虽然维基、代码和问题跟踪器的 URI 通常不会随版本更改,但文档和变更日志链接通常需要随每个新版本更新。在 Rubygems.org 中,我们喜欢在您将其推送到我们的服务器后立即认为版本不可变。尽管我们有替代方案,即更新belongs_to: versions的 linkset 关系,但它不符合我们对不可变版本的假设。

移除 UI 窗体让 gemspec 成为链接数据唯一真实来源并赋予 gem 发布者对它们的更多控制权。那些使用 CI 构建来发布 gem 的人会发现使用 gem 规范比使用 UI 更方便。此外,Rubygems.org repo 生成了超过 200 行代码用于移除窗体。根据某些说法,足够两个 Ruby 类占用的空间。

我们理解有时您需要完成某些事情。如果您确实身处无法发布新版本来更新这些链接的情况下,请随时提交支持票证,届时我们将为您更新。话虽如此,我们也希望您认为元数据链接是一个有用的补充,并且您将在您的下一个版本发布中使用它们。如果您仍然犹豫不决,那么汇编一些书籍末尾风格的名言可能有助于您做出决定。

名言来源