Não crie documentos mortos #

Elimine papelada desnecessária #

Evitar especificações funcionais é um bom começo, mas não pare por aí; previna excesso de papelada em todos os lugares. A menos que um documento vá realmente se transformar em algo real, não o produza.

Construa, não escreva. Se você precisa explicar algo, tente fazer um mockup e prototipá-lo em vez de escrever um documento longo. Uma interface real ou protótipo está a caminho de se tornar um produto real. Um pedaço de papel, por outro lado, está apenas a caminho da lixeira.

Aqui vai um exemplo: Se um documento de wireframe está destinado a parar e nunca se tornar o design real, não se dê ao trabalho de fazê-lo. Se o wireframe começa como um wireframe e depois se transforma no design real, vá em frente.

Documentos que vivem separadamente da sua aplicação são inúteis. Eles não te levam a lugar nenhum. Tudo o que você faz deve evoluir para a coisa real. Se um documento para antes de se tornar real, ele está morto.

Ninguém Vai Ler #

Eu nem consigo contar quantas especificações de produto de várias páginas ou documentos de requisitos de negócios que ficaram esquecidos, não lidos, acumulando poeira perto da minha equipe de desenvolvimento enquanto codificávamos, discutindo problemas, fazendo perguntas e testando com usuários à medida que íamos. Eu até trabalhei com desenvolvedores que passaram horas escrevendo longos e-mails descritivos ou documentos de padrões de codificação que também não foram lidos.

Aplicativos web não avançam com documentação copiosa. O desenvolvimento de software é um processo constantemente mutável e iterativo que envolve interação, decisões rápidas e problemas impossíveis de prever que surgem ao longo do caminho. Nada disso pode ou deve ser capturado no papel.

Não perca seu tempo digitando aquele longo tomo visionário; ninguém vai lê-lo. Conforte-se com o fato de que, se você der ao seu produto espaço suficiente para crescer por si só, no final ele não se parecerá com nada do que você escreveu de qualquer maneira.

—Gina Trapani, desenvolvedora web e editora do Lifehacker, o guia de produtividade e software