grep -r "documentacao" /noticias/
-
O título já diz tudo: código é como um cartão de visita do que está acontecendo, mas isso não diz necessariamente o que deveria acontecer. Quando você precisa modificar ou depurar, fica evidente que o código não comunica todas as intenções por trás dele. E, como mencionado, "descobrir a intenção é mais difícil" e ainda mais quando falamos de sistemas distribuídos. Um bom lembrete de que documentar e manter a clareza no código é tão essencial quanto escrever um código funcional passa batido na maioria dos círculos, e isso pode custar bem caro quando precisamos entender quais 'quirks são load-bearing'.
-
Finalmente, alguém decidiu dar uma cara nova à documentação do Git. O artigo menciona que "observamos que o Git usa os termos 'objeto', 'referência' ou 'índice' na sua documentação, mas não tinha uma boa explicação sobre o que esses termos significam". Essa atualização, que resultou em um novo documento de modelo de dados, pode ajudar até mesmo os desenvolvedores mais experientes a entenderem melhor como o Git funciona, como um debugger encontrando um bug. Além disso, pedir feedback a usuários experientes é uma jogada inteligente; afinal, não importa quanto tempo você use Git, sempre há algo novo para aprender.
-
Melhorar as páginas man é sempre uma boa jogada, especialmente para ferramentas como tcpdump e dig, que podem deixar até os mais experientes em apuros com suas opções complexas. O autor foca em incluir exemplos básicos que simplificam a curva de aprendizado dessas ferramentas, algo bem necessário. Como ele mesmo diz, "isso tem funcionado muito bem", e quem não gostaria de um suporte melhor na hora de usar uma linha de comando? Com informações precisas e revisadas, é um passo na direção certa para tornar a documentação tão boa quanto a de um blog confiável.
< anterior
pagina 1 de 1
proxima >