试用版发布后如何以模块作者的身份进行

时间:2019-06-21 05:11:24

标签: perl cpan

使用Perl5进行编程,使用Dist::Zilladzil)进行部署到CPAN时,出现了问题。但是这个问题可能是一个普遍的问题,其含义与编程语言无关。

问题描述

假设我要发布模块0.1的新版本Foo,并具有名为bar的新功能。我想将其作为试用版(dzil build --trial)发布,以便能够获得有关更改的反馈,而不必将其强加给无意识的用户。使用工具链进行操作时,Changes文件将如下所示:

1 Revision history for Foo
2
3 0.1       2019-06-19 17:49:09+02:00 Continent/City (TRIAL RELEASE)
4  - added bar

打包分发文件(用于上传到CPAN)是这样的文件:Foo-0.1-TRIAL.tar.gz

直到这里,一切都很容易。但是从现在开始,我不确定如何应对即将发生的事件:

  • 反馈是积极的。无需更改。将发布版本投入生产。

新版本(但未更改)的外观应如何? 我应该发布具有相同版本的版本还是增加版本?我应该在Changes文件中添加新行(例如“将试用版0.1投入生产”)还是更改现有行(意味着只删除(TRIAL RELEASE))。

  • 反馈为负。需要更改。添加功能/更改baz

这里有同样的问题。当然,新的更改需要在Changes中提及。但是再说一遍:算上版本,还是顺其自然?在Changes中输入新条目还是更改现有条目?

这是我感觉到的以下问题之一:可能无关紧要,但是必须有“最佳实践”。从长远来看,做对是有回报的。

问题

在专门针对CPAN进行试用发布后,如何继续版本编号和Changes文件?

(与Perl和CPAN无关的一般答案也很有趣)

1 个答案:

答案 0 :(得分:1)

我的一般建议是:如果TRIAL证明是一次巨大的成功,并且在没有--trial的情况下发布相同内容,则除了零更改之外,您可以重用该版本,因为在运行时,两个tarball会有相同的行为。如果必须进行可能影响用户或测试的任何更改,请更改版本。如果不确定,请更改版本-版本是免费的。请记住,如果没有不同的版本,其他发行版将无法区分其依赖项的更改,CPAN客户端也无法轻松地请求特定版本,等等。

就变更日志而言,如果it can parse your changelog和试用版均已标明,则MetaCPAN现在可在其变更预览中包括所有导致稳定版的试用版的变更。 (example)因此,我只为每个不同的版本添加一个条目。