Engenharia Gentil

O que é gentileza?

Kind is about being invested in other people, figuring out how to help them, meeting them where they are.

Gentileza é investir nas outras pessoas, descobrir como ajudá-las e encontrá-las onde elas estão.

— Tanya Reilly, Continuous

Gentileza, como Tanya Reilly diz acima, é investir nas pessoas. Não se trata apenas de ser amável, mas de se colocar no lugar da outra pessoa e compreender seus sentimentos e contexto. Não é uma solução universal para todas as situações, mas pode ajudar a resolver vários problemas.

Cordialidade

• Vá além de ser apenas "profissional" e concentre-se no seu trabalho.
• Seja aberto e humano para construir confiança.
• Lide diretamente com as pessoas, mas cuide delas com consideração.
• Mentiras inocentes não são necessariamente ruins, mas não ajudam as pessoas a crescer.
• Não perca a cordialidade, elogie as boas atitudes e ofereça pontos de melhoria.

Comunicação assíncrona (async)

• Em mudanças, procure entender mais não apenas o "o quê?" e o "como?", mas também o "por quê?".
• Não presuma malícia nem incompetência.
• Em vez de fazer afirmações duras ou controversas, faça perguntas abertas.
• Antes de apontar algo, é importante que os rótulos estejam claramente definidos.
• Apontar coisas em excesso pode atrapalhar ainda mais o trabalho.
• Se houver muitas opiniões, mude a comunicação para um formato sequencial.

Segurança psicológica

• Seja o primeiro a pedir feedback à equipe ou aos colegas.
• A estrutura do feedback é simples:
  • O que foi bem
  • O que deu errado
  • O que fazer depois
• Aceite com abertura os contextos, históricos e preferências pessoais das pessoas.
• Observe quem não consegue contribuir muito em reuniões ou documentos e encontre formas de ajudá-los a ter voz.
• Defenda que as pessoas possam se expressar de qualquer forma que considerem adequada.
• Muitas vezes, falhas individuais podem na verdade revelar falhas de processo, ambiente ou fluxo de trabalho.
• Nós temos sucesso e falhamos juntos.
• Todo "fracasso" ou incidente deve ser celebrado como uma oportunidade de crescimento e aprendizado.
• Para promover a inovação, é preciso incentivar as pessoas a assumir riscos, desafiar e sentir que esse tipo de atitude é seguro.

Feedback/crítica

• Desde o início, seja a pessoa que recebe avaliação primeiro, e não a que avalia.
• Não transforme isso em algo pessoal.
• Ao dar feedback ou elogios, procure ser o mais específico e completo possível.
• Se você der um feedback crítico a alguém, tente também sugerir uma solução.
• Entenda suas próprias preferências em relação a feedback.
• Ouça e compreenda, depois agradeça a quem deu o feedback.
• Não reaja imediatamente; reserve um tempo para organizar seus pensamentos e processar o feedback.
• Peça explicações ou exemplos.
• Lembre-se dos três elementos de dar feedback:
  • Emoção
  • Credibilidade
  • Lógica
• Considere os sentimentos de quem ouve, não os seus.
• Demonstre profissionalismo e humildade.
• Mostre sua forma de trabalhar e como você chega às conclusões.

---

• O problema do tom tóxico na indústria de tecnologia — vamos consertá-lo!

[arfwene]

É algo óbvio, mas difícil de colocar em prática..

[aster]

Com base no material acima, pensei em como aplicar engenharia gentil no desenvolvimento
Com a ajuda de IA, montei algo que chamei de KDD (Kindness Driven Development).

Escrita de código

• Escreva comentários e documentação com foco no “por quê?”. É importante explicar a razão da existência do código e seu contexto.
• Em lógicas complexas, use nomes de variáveis e funções com termos do domínio para facilitar o entendimento por outros desenvolvedores.
• Ao introduzir novas tecnologias ou padrões, leve em conta a curva de aprendizado da equipe.
• Não critique o código legado. Provavelmente havia restrições e contexto naquele momento.
• Documente o tratamento de casos de borda e de falha para quem fizer a manutenção no futuro.
  Arquitetura
• Ao projetar o sistema, considere também a perspectiva das equipes de operações e QA.
• Facilitar monitoramento e depuração também faz parte de um design gentil.
• Um design escalável é uma forma de consideração com os futuros membros da equipe.
• Ao gerenciar dívida técnica, busque um “nível administrável”, não a eliminação perfeita.
• É importante criar uma estrutura que facilite a adição de novas funcionalidades.
  Code review
• Ao pedir revisão, explique com clareza o contexto das mudanças.
• Use feedback em tom de sugestão, como “que tal fazer assim?”.
• Não deixe de mencionar os pontos positivos. “Esta parte ficou realmente bem limpa.”
• Ao sugerir alternativas, explique também o motivo.
• Melhorias que não são urgentes devem ser registradas separadamente como issue, respeitando o escopo do PR atual.
  Testes
• Forneça mensagens de erro claras quando um teste falhar.
• Casos de teste também funcionam como documentação. Escreva testes que expliquem bem as regras de negócio.
• Crie uma estrutura em que outros desenvolvedores consigam adicionar testes com facilidade.
• Use exemplos reais e fáceis de entender como dados de teste.
• Automatize a configuração do ambiente de testes para reduzir a barreira de entrada.
  Deploy e operações
• Inclua explicações e guias suficientes nos scripts de deploy.
• Prepare com antecedência logs que ajudem na depuração em caso de incidentes.
• Se houver necessidade de mudanças de configuração, documente o impacto.
• Ao lançar uma nova funcionalidade, prepare também um plano de rollback.
• Escreva o guia de operações do ponto de vista de um desenvolvedor júnior.
  Compartilhamento de conhecimento
• Documente e compartilhe experiências de troubleshooting.
• Ao introduzir uma nova tecnologia, crie e compartilhe materiais de aprendizado.
• O guia de escrita de código deve incluir “por que decidimos fazer assim”.
• Promova o crescimento da equipe com momentos regulares de compartilhamento técnico.
• Criar um ambiente em que seja fácil fazer perguntas ajuda no crescimento dos desenvolvedores juniores.

[bbulbum]

É um conteúdo tão bom que daria até para escrever um texto separado sobre isso, haha.

[laeyoung]

Muito bom!

[aer0700]

É um comentário muito bom.