Todo dezembro, algumas centenas de milhares de desenvolvedores encaram o Advent of Code e boa parte deles publica suas soluções. Quase sempre como imagens, e quase sempre no tamanho errado.

O motivo de as imagens vencerem é simples: a maioria das plataformas estraga código colado — a indentação desaba, o colorido some e um one-liner esperto vira um borrão ilegível. Uma imagem sobrevive a tudo isso. A contrapartida é real e merece ser dita: uma imagem não pode ser copiada, pesquisada nem lida por um leitor de tela, então publique um link para o código junto.

Publique a parte interessante, não o arquivo inteiro

O erro mais comum é capturar o arquivo de solução inteiro. Ninguém lê uma imagem de 60 linhas no celular. As soluções do Advent of Code quase sempre têm uma única ideia interessante dentro: o parsing, a recorrência, o truque que transformou a força bruta em algo instantâneo. Capture isso e deixe o link do repositório carregar o resto.

Dez a quinze linhas é o teto do que se lê numa timeline.

Dimensione para a plataforma, não para a sua tela

É aqui que quase toda imagem de solução tropeça. Um trecho que fica ótimo num monitor de 27 polegadas vira texto corpo seis dentro de um feed.

  • Um post de timeline pede 16:9 ou 4:3. Mais largo que isso e o texto encolhe para caber.
  • Um feed vertical pede 9:16 ou 3:4, o que aliás combina com o formato alto e estreito que a maioria das soluções já tem.
  • Em qualquer lugar, exporte em 2× ou 3×, porque uma imagem em 1× numa tela retina parece borrada e meio amadora.

No Codeshot isso é a seção Proporção: mude de Original para Fixa, escolha a proporção e defina a escala de exportação. Os mesmos três controles sempre.

Escolha um tema com contraste

As threads de dezembro são um paredão de imagens de código, e as que são lidas são as que se leem de relance. Temas de alto contraste seguram texto pequeno melhor do que os discretos. Tokyo Night, Atom One e Solarized aguentam bem quando reduzidos; vários dos temas de menos contraste não.

Você pode comparar os 30 aqui antes de fechar com um para o mês inteiro.

Mantenha a consistência pelos 25 dias

Se for publicar diariamente, decida tema, fundo e proporção no primeiro dia e não mexa mais. Consistência é o que torna uma série reconhecível num feed — e, na prática, elimina os vinte segundos de ajuste que são o verdadeiro motivo de as pessoas desistirem lá pelo décimo primeiro dia.

Um app nativo ajuda aqui porque guarda a sua configuração entre as aberturas. Configure no dia primeiro, e cada dia seguinte é colar, exportar, publicar.

Uma nota sobre spoilers

O criador do Advent of Code pede que as pessoas não publiquem soluções em aberto antes de o placar encher. Confira as orientações do ano corrente e, na dúvida, publique depois que o dia terminar em vez de durante.

Se quiser o fluxo completo, ele está em Como transformar código em imagem.