Я про сокращение доков много читал/учил до того как стал работать ГД. А как стал работать пришёл к тому, что лучше наоборот максимально подробно писать. Главное хорошо структурировать.
По количеству текста и сокращений. Смысл текста не должен теряться от сокращений. Поэтому у меня все сокращения сводятся к выбору максимально компактных и емких формулировок не допускающий разночтений.
По поводу подробности. При описании стараюсь учитывать все приходящие в голову кейсы взаимодействия. Но пока опыт говорит, что все равно что-то упустишь +)