как стать автором модуля после пробной версии - PullRequest
2 голосов
/ 21 июня 2019

Проблема возникает со мной, используя Perl5 для программирования и Dist::Zilla (dzil) для развертывания в 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 или изменить существующую?

Это один из этих вопросов, где я чувствую: это, вероятно, не имеет большого значения, но должна быть "лучшая практика".И в долгосрочной перспективе это отчасти выгодно.

Вопрос

Как мне продолжить с нумерацией версий и файлом Changes после пробной версиивыпуск специально для CPAN?

(Общие ответы, которые не зависят от Perl и CPAN, также представляют интерес)

1 Ответ

1 голос
/ 21 июня 2019

Мой общий совет: если TRIAL оказывается ошеломительным успехом, и нет никаких изменений, за исключением выпуска одной и той же вещи без --trial, вы можете повторно использовать версию, так как во время выполнения два тарбола будут вести себя одинаково , Если вам нужно внести какие-либо изменения, которые могут повлиять на пользователей или тесты, увеличьте версию. Если вы не уверены, поднимите версию - версии бесплатны. Помните, что без отдельной версии другие дистрибутивы не смогут различить изменения в их зависимостях, клиенты CPAN не могут легко запросить конкретную версию и т. Д.

Что касается журнала изменений, то может помочь то, что MetaCPAN теперь включает изменения для любых пробных выпусков, ведущих к стабильному выпуску, в свой предварительный просмотр изменений, при условии, что может анализировать ваш список изменений , и пробные выпуски помечены как таковые. ( пример ) Поэтому я бы просто включил запись для каждой отдельной версии.

...