April 6th, 2007

подмигивающий

Тексты для роботов

Почему-то большинство инструкций пишутся без рассчета на то, что их будут читать люди а не машины. Читаю описание протокола SOAP (ну в принципе тем, кто не знает, что это такое - могут не смотреть).
И ловлю себя на мысли, что большинство текстов должно начинаться с того, что опишут "зачем", а потом "что" было реализовано.
Читал когда-то гениальную книгу по составлению текстов. Называлась она "Золотые правила Гарварда и McKinsey", автор Барбара Минто (купить ее кстати совершенно невозможно)