Нехватка документации
Парни, движёк охрененный, честно, все классно, но несколько дней сижу прикручиваю модуль и испытываю жуткую нехватку документации и примеров по движку! Всю информацию приходится искать по крупицам по всему сайту, а та скудная вики, что есть сейчас, даёт лишь образное представление о работе. Жесть. Нужно менять как то ситуёвину. Очень нужно.
12 комментариев
тем не менее я очень жду
С моего ящика ежедневно уходит несколько писем с разъяснениями, советами, «тыками» в куски кода, указыванием на ошибки, объяснениями почему не обязательно вносить в ядро функционал по автоматическому импорту RSS-лент и почему я не могу отобрать у benone-а галерею и включить ее в стандартную комплектацию движка…
Хватит на двухтомный бестселлер.
И еще несколько размышлений:
1. Писать об использовании функционала до выхода релиза не вижу особого смысла.
2. Если мы сейчас бросим писать код и сядем писать документацию, сколько будет недовольных, что медленно продвигается разработка? Меньше или больше, чем сейчас недовольных отсутствием доки? Всегда хочется чего-то большего, но всего сразу не бывает.
3. Лично я не собираюсь ни на что подстегивать разработчиков модулей, давить на них и т.д. Разработка модуля — дело доброй воли, выкладывание его в пользование другим — то же, почему же написание документации должно быть подотчетно-обязательным? Подстегивать других проще всего. Что-то реально делать, намного сложнее.
в остальном на 300% согласен.
буду Вашим читателем ))
почему бы не использовать это в качестве FAQ? :)
насчет документации: Как только разберусь, что и как теперь в транке, тоже попробую пару статей написать :)