Estou tentando documentar um software que escrevi em detalhes. Um SAS é muito alto e não cobre a API. Encontrei vários exemplos de um SDS online, mas não vejo uma tendência em seu formato.
Gostaria de saber se existem algumas diretrizes gerais para escrever uma especificação de design de software ou qual é a melhor abordagem?
documentation
api
uml
design
sj755
fonte
fonte
Respostas:
Você poderia fazer muito pior do que começar com a Descrição do Item de Dados do Documento de Design de Software DOD-STD-2167A .
O Departamento de Defesa dos EUA tem muita experiência em desenvolvimento de software, muito mais do que qualquer empresa. Eles também têm um grande interesse em obter software que fizesse o trabalho e que pudesse ser mantido no caminho. Eles se deram ao trabalho de descobrir quais informações precisavam estar nos vários documentos que suportam um projeto de software, usando a experiência de um grande número de projetos e mais do que algumas falhas muito caras.
O DID do Plano de Desenvolvimento de Software (disponível aqui ) inclui vários itens que devem ser abordados. Se você olhar atentamente, perceberá que essas seções estão escritas no sangue de gerentes de programas que falharam em abordar esses itens.
fonte