Указать меньше, ** расширить подробнее **.
Ограничьте свои спецификации до нужных предметов, ** сосредоточьтесь на «чем» **, а не на «как».
Продукт должен быть максимально ** самодокументированным **.
Документация должна быть версирована так же, как и код.