Здравствуйте, Аноним, Вы писали:

А>Интересно ты рассуждаешь. Если вообще ничего не написать, то программер не будет задавать вопросов?
А>Думаю, что просто не будет работать

Когда много текста он обычно читается по диагонали соответственно жди вопросов. Это человеческий фактор. Описание должно быть достаточно кратким.

А>А инициатива программерская тоже признак крутезны, так как программист должен додумать некие ньюансы.

Иногда лучше уточнить чем потом переделывать.