|
Нет, это теперь уже понятно конечно то, о чем вы говорите. Но когда я в примере вижу tpl с быстрой инициализацией по строке, сложно догадаться что в хорошем структурированном мане нужно поискать класс с таким названием, а найдя его, открыть описание метода XTemplate и, о чудо, там окажется описание синтаксиса. Говоря о структурированности мана, подобное описание более привычно смотрелось бы в описании класса, и его наличие сразу же бросалось бы в глаза в отличии от скромной фразы в конце "примеры смотрите в конструкторе". Не имея ничего против подхода разработчиков к размещению информации вам я могу заметить, что для того кто еще не сталкивался с таким нюансом документации - это далеко не очевидно. Т.е. в мане надо знать что искать и надо знать как искать. И если вас спрашивают, то наверное не все так просто, как кажется вам, уже разобравшемуся с этими вопросами.
|