Je suis le genre étrange de développeur qui aime écrire et expliquer - les e-mails, les spécifications, vous l'appelez. J'aime aider les gens à comprendre les choses en profondeur. Je déteste les communications de ping-pong où les groupes passent par 30 ou 40 courriels, appels téléphoniques et réunions parce que 25% du groupe ont mal compris le courriel précédent en pointillés dans lequel l'écrivain n'a expliqué qu'à moitié sa position, ou était pressé et a mal écrit un mot critique ou omis un ou deux négatifs.
Cette caractéristique est idéale pour la documentation, mais mes courriels sont longs, donc les gens ne les lisent tout simplement pas. Quelques stratégies que j'ai utilisées consistent à mettre en forme de longs courriels en tant que documents Word joints pour encourager les gens à les voir comme de la documentation (cela fonctionne étonnamment bien parfois), ou à essayer d'utiliser plus de puces au lieu de paragraphes gratuits. Ces stratégies augmentent le lectorat, mais le contenu est encore long.
Bien sûr, je veux crier et crier que les sujets techniques complexes nécessitent beaucoup d'exposition et de clarification, mais cela n'aide personne. De toute évidence, il y a des compromis à faire, mais j'ai du mal à justifier des déclarations qui ne sont pas claires ou qui entraîneront un million de questions, des malentendus ou l'ajout de "termes et conditions" plus tard.
Comment gardez-vous vos communications courtes mais complètes?