linux-BR.org

Notícias de software livre e tecnologias

A decisão de escrever um documento de design se resume ao trade-off principal de decidir se os benefícios no consenso organizacional em torno do design, documentação, revisão sênior etc., isto é, dado o contexto (fatos), objetivos e não-objetivos (Requisitos), o Doc do design é o local para sugerir soluções e mostrar por que uma solução específica satisfaz melhor esses objetivos.À medida que os planos colidem com a realidade, é inevitável que as deficiências, requisitos não tratados ou suposições educadas que acabaram sendo superficiais e exigem a alteração do design.No caso de documentos dedicados para esses tópicos, o Doc do design central pode, é claro, referenciá -los em vez de entrar em detalhes.Observe que os não-objetivos não são objetivos negados como “o sistema não deve travar”, mas coisas que podem razoavelmente ser objetivos, mas são explicitamente escolhidos para não serem objetivos.

Fonte: https://www.industrialempathy.com/posts/design-docs-at-google/