O que faz uma boa especificação? [fechadas]

Um dos itens noJoel Test é que um projeto / empresa deve ter uma especificação.

Eu estou querendo saber o que faz uma especificação boa. Algumas empresas escrevem volumes de especificações inúteis que ninguém lê, outras não escrevem nada porque "ninguém lê nada disso". Então, o que você coloca em suas especificações? Qual é o bom equilíbrio entre os dois extremos? Existe algo particularmente importante que realmente, realmente (!) Deve sempre ser registrado em uma especificação?

questionAnswers(12)

yourAnswerToTheQuestion