Diffs
Às vezes a própria mudança é a lição: uma refatoração, uma correção de bug, uma migração, um PR. Um slide de diff coloca as duas versões lado a lado, o antes à esquerda e o depois à direita, e colore automaticamente as linhas e palavras que mudaram.
Em uma tela estreita, os painéis ficam empilhados, com o antes acima do depois.
A narração percorre a mudança em ordem: o que havia antes, no que se transformou e por que essa mudança aconteceu. O ponteiro salta entre os dois painéis, indo até a linha antiga e depois até sua substituta, então você nunca precisa comparar os dois lados por conta própria.
Como conseguir bons slides de diff
Os slides de diff funcionam melhor com um agente de código conectado: explique o que esse PR muda ou crie um explicador da correção que acabamos de fazer gera diffs dos seus commits reais. No scrimba.com, cole as duas versões e peça a comparação, ou anexe os arquivos.