Sinopse do Episódio "Código como Documentação"
Qual a documentação necessária pro sistema? O código fonte é o suficiente? Conhece 'código como documentação'? Vem trocar ideia com a gente. Participantes Marcio Frayze David [email protected] https://twitter.com/marciofrayze https://segunda.tech https://masto.donte.com.br/web/accounts/138458 https://linkedin.com/in/marcio-frayze Julianno Martins Silva [email protected] https://twitter.com/juliannoms https://linkedin.com/in/juliannoms Links: Artigo do Fowler: https://www.martinfowler.com/bliki/CodeAsDocumentation.html Artigos do Jack Reeves recomendados pelo Fowler: https://www.developerdotstar.com/mag/articles/reeves_design.html https://www.developerdotstar.com/mag/articles/reeves_13yearslater.html https://www.developerdotstar.com/mag/articles/reeves_originalletter.html Spring REST Docs: https://spring.io/projects/spring-restdocs Vídeo da Punk do DevOps falando sobre padrões nas mensagens de commit: https://www.youtube.com/watch?v=vXOVl6TxuOE&t=388s Outra convenção para mensagens de commit: https://www.conventionalcommits.org/pt-br/v1.0.0/ Mais uma convenção para mensagens de commit: https://karma-runner.github.io/6.1/dev/git-commit-msg.html Artigo contrário à nossa ideia, com baixa abstração: https://medium.com/it-dead-inside/self-documenting-code-is-mostly-nonsense-1de5f593810f
Ouvir "Código como Documentação"
Mais episódios do podcast p de Podcast
- Pattern Matching for instanceof
- Feedback
- Teste A/B (e porquê isso importa)
- Coragem
- Generics mais avançado: Invariância, Covariância, Contravariância e Bivariância
- Generics Básico
- Migrations
- Vazamento de memória
- Diga, não peça (Tell, don’t ask)
- Código como Documentação
- Programação em Par
- Estrangulamento de Software
- Transações Distribuídas
- ACID, BASE e o Teorema CAP
- Software Resiliente
- Monólito Primeiro e Design Simples
- Retrospectiva 2020
- Arquitetura Baseada em Serviços (Service-based Architecture)
- Linguagem onipresente
- Programação Assíncrona
- O resto do REST
- REST: você (provavelmente) está fazendo isso errado
- Refatoração: o que é e como fazer
- SRP x CRUD (Bônus)
- SRP: O Princípio da Responsabilidade Única
- Injeção de dependência e inversão de controle
- Por que usar programação funcional em linguagens OO?
- UX: Por que todo mundo está falando disso?
- Integração Contínua não é (apenas) automatizar a build
- Pare de usar IF/Else
- ORM amar ou odiar?
- Imutabilidade e programação defensiva
- DevOps
- Código limpo
- Frameworks e o seu impacto na arquitetura de software
- TDD: Desenvolvimento Guiado Por Testes
- p de Podcast
- Arquitetura de software no desenvolvimento mobile
- Arquitetura Monolítica versus Microsserviços - parte 3
- Arquitetura Monolítica versus Microsserviços - parte 2
- Arquitetura Monolítica versus Microsserviços - parte 1
- O que é Arquitetura de Software?