Неполная документация - несомненное зло.
Sep. 2nd, 2007 05:18 pmХотя, конечно, можно что-нибудь сказать про радость неожиданных открытий, но в технике этому места нет.
Дело даже не в недокументированных функциях, которые могут вдруг оказаться полезнее документированных. Дело в том, что нужное и явное свойство не то, чтобы совсем не было описано - оно просто упоминается едва-едва, всколзь, намёком. Я не понимаю, с какого пуркуа от разработчика почти что требуется быть инсайтером? Нет, само-то по себе это прикольно, весьма. Но когда надо доводить до ума устройство, которое не работает лишь потому, что в документации на него кое-чего чуть-чуть недописано - это пиздец, извините мой французский.
Дело даже не в недокументированных функциях, которые могут вдруг оказаться полезнее документированных. Дело в том, что нужное и явное свойство не то, чтобы совсем не было описано - оно просто упоминается едва-едва, всколзь, намёком. Я не понимаю, с какого пуркуа от разработчика почти что требуется быть инсайтером? Нет, само-то по себе это прикольно, весьма. Но когда надо доводить до ума устройство, которое не работает лишь потому, что в документации на него кое-чего чуть-чуть недописано - это пиздец, извините мой французский.
no subject
Date: 2007-09-02 05:15 pm (UTC)