Obrigado pelas sugestões! A propósito, estava pesquisando como automatizar outras tarefas, e encontrei mais uma ferramenta interessante: o pod2markdown (parte do Pod::Markdown).
Com ele podemos criar a documentação em apenas um lugar (POD), e gerar o README.md (usado no github) automaticamente. []s Nelson Em 24 de setembro de 2013 14:16, Renato Santos <[email protected]> escreveu: > Eu escrevo o Changes na mão, > > dificilmente vai ficar no formato 'legal' usando alguma ferramenta > automatica para escrever, > > você pode olhar ali no http://changes.cpanhq.org/ como esta seus modulos > > > > 2013/9/24 Blabos de Blebe <[email protected]> >> >> Opa, >> >> Eu cheguei a testar alguns plugins do Dist::Zilla. >> >> Dá pra atualizar o Changes diretamente com as mensagens de commit do git e >> dá pra incrementar o número de versão automaticamente. >> >> Mas sinceramente não gostei e marquei pra rever isso no futuro. >> >> >> 2013/9/24 Tiago Peczenyj <[email protected]> >>> >>> aqui estamos utilizando git + redmine >>> >>> o changelog é atualizado e em um dado momento nós geramos uma nova versão >>> e fazemos release no cpan interno. nesse caso o VERSION é injetado em todas >>> as classes por um plugin do dist::zilla >>> >>> pode fazer sentido fazer isso se vc junta algumas tasks para fazer um >>> release. >>> >>> >>> 2013/9/24 Stanislaw Pusep <[email protected]> >>>> >>>> Eu configurei o Dist::Zilla para fazer tudo automagicamente. Confesso >>>> que tem os seus pontos negativos, mas a conveniência supera, ao menos para >>>> mim. >>>> Ele mantém tags com versões no GitHub e cria Changelog com as mensagens >>>> dos commits. Por exemplo: https://metacpan.org/release/Algorithm-SlopeOne >>>> Isso foi gerado com esta configuração: >>>> https://github.com/creaktive/Algorithm-SlopeOne/blob/master/dist.ini >>>> Tem gente que faz um bundle, assim vc coloca um echo '[@DoEverything]' > >>>> dist.ini e pronto. A minha preguiça ainda não atingiu esse ponto, mas para >>>> evitar copy/paste criei um perfil (Dist::Zilla::MintingProfile::SYP) que >>>> inicializa os novos módulos com configurações +/- padrões. >>>> >>>> >>>> 2013/9/24 Alceu Rodrigues de Freitas Junior <[email protected]> >>>>> >>>>> Em 24-09-2013 07:01, Nelson Ferraz escreveu: >>>>> >>>>>> Pessoal, >>>>>> >>>>>> Como é que vocês lidam com o versionamento de seus módulos e >>>>>> aplicações? >>>>>> >>>>>> Vocês usam algum tipo de script para incrementar a versão (x.y.z) e >>>>>> atualizar o Changelog? Ou fazem isso manualmente? >>>>>> >>>>>> Idéias são bem vindas. >>>>>> >>>>>> []s >>>>>> >>>>>> Nelson >>>>> >>>>> >>>>> Eu acho a ideia de incrementar $VERSION com base na criação de um >>>>> branch no sistema de controle de versão (você vai ter que criar uma >>>>> convenção para isso). Quando você cria o ramo e faz commit, pode criar um >>>>> script para incrementar $VERSION. >>>>> >>>>> Eu gosto de criar o Changelog automaticamente quando vou liberar uma >>>>> nova versão: como eu ainda uso o Subversion, tem o svn2cl que faz o >>>>> trabalho. Depois de extrair, eu edito manualmente o Changelog para deixar >>>>> apenas as partes interessantes. >>>>> >>>>> []'s >>>>> Alceu >>>>> >>>>> >>>>> =begin disclaimer >>>>> Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ >>>>> SaoPaulo-pm mailing list: [email protected] >>>>> L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> >>>>> =end disclaimer >>>> >>>> >>>> >>>> =begin disclaimer >>>> Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ >>>> SaoPaulo-pm mailing list: [email protected] >>>> L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> >>>> =end disclaimer >>>> >>> >>> >>> >>> -- >>> Tiago B. Peczenyj >>> Linux User #405772 >>> >>> http://about.me/peczenyj >>> >>> =begin disclaimer >>> Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ >>> SaoPaulo-pm mailing list: [email protected] >>> L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> >>> =end disclaimer >>> >> >> >> =begin disclaimer >> Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ >> SaoPaulo-pm mailing list: [email protected] >> L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> >> =end disclaimer >> > > > > -- > Saravá, > Renato CRON > http://www.renatocron.com/blog/ > @renato_cron > > =begin disclaimer > Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ > SaoPaulo-pm mailing list: [email protected] > L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> > =end disclaimer > -- Nelson Ferraz =begin disclaimer Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ SaoPaulo-pm mailing list: [email protected] L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> =end disclaimer
