deixando o codigo_mais_amigavel_para_as_proximas_geracoes
TRANSCRIPT
Como montar uma palestra com seu conhecimento dos
últimos mesesFabio PerrellaLider TécnicoHospedagem
http://www.greaterthancode.com/podcast/008-sandi-metz-and-katrina-owen/
https://github.com/fabioperrella/my-changelog/blob/master/CHANGELOG.md
Agenda
- Documentação- Histórico de commits- Limpeza do código- Testes claros- Merge requests construtivos
Keepachangelog.comDocumentação de gems
- Ajuda muito na hora de precisar atualizar de uma versão X para Y
http://code.locaweb.com.br/paas/provisioning-core/blob/master/CHANGELOG.md
Contando a história do código através dos commitshttps://about.futurelearn.com/blog/telling-stories-with-your-git-history/
Explicar o porquê e não só o “como”http://chris.beams.io/posts/git-commit
Commit --fixup para atualizar commit antigohttps://robots.thoughtbot.com/autosquashing-git-commits
Module prependhttp://gshutler.com/2013/04/ruby-2-module-prepend/
Module prependVantagens sobre a gem aspector:
- fica explícito no código!- aparece no stacktrace explicitamente em caso de exceção
Mais clareza com keyword argumentshttp://gshutler.com/2013/04/ruby-2-module-prepend/
Remoção de código obsoletogem debride
https://github.com/seattlerb/debride
Proposta- Não se importe muito com DRY. Caso se importe, prefira uso de métodos- Evite o uso de LETs e BEFOREs- Tudo bem colocar mais de 1 expect dentro dos ITs- Separe em 3 blocos: setup, exercise e verify
http://blog.locaweb.com.br/geral/melhorando-o-entendimento-de-testes-com-rspec
Merge requests construtivos- Torna o código mais entendível- Reduz chance de bugs- Espalha conhecimento entre membros- Serve de referência para futuras consultas
Guideline de hospedagem:
apps-hospedagem.docs.arda.locaweb.com.br/guidelines/merge-requests.html
Exemplohttps://code.locaweb.com.br/paas/hodor/merge_requests/267