Lembre-se de que o leitor da documentação não está tão familiarizado com o código quanto você e provavelmente não se preocupa com a beleza intrínseca de seus adoráveis algoritmos. O leitor deseja saber “O que esse código pode fazer por mim?” e “Como faço para fazer o que eu preciso fazer?” Escreva sua documentação para responder às perguntas dos leitores, e você e eles vencerão!