Планируем Limb3 2010.1

[korchasa]

Тесты проходят (на моей недокомиченной версии). Правда пока только с форком. Без форка не проходят из-за невозможности сбросить кэш локаторов в lmbFsTools::getLocator()

Предлагаю подумать над следующими вещами:

• wact - 3 ошибки. ИМХО, стоит поправить
• log - нет тестов. Надо дописать
• zfsearch - нет тестов. Оно нам надо?
• scripts - нет тестов. Оно нам надо?

Самая большая проблема документация. Сейчас я наблюдаю за двумя людьми, которые только начали работать с limb'ом, и вижу, что в доке ориентироваться сложно, а местами в ней путсто. Сейчас пытаюсь сделать алтернативное представление оглавления. Только там, наверное, надо ориентироваться не на пакеты, а на их функционал. Как "образец" думаю использовать PHP мануал + The Definitive Guide to symfony.

[Forumsky]

Ещё зендовский мануал меня лично вполне устраивает: http://framework.zend.com/manual/en/
Они делают документацию через http://docbook.sourceforge.net/ похоже что он и используется на http://php.net
То есть мне кажется что кроме самого содержания документации, стоит уделить внимание на чём она пишется.

В общем проблема документация очень важная: получается что функционал есть, а пользоваться им могут очень не многие, то есть эффективность низкая. Может организовать рабочую группу по этому вопросу, добавить блок на главную страницу, написать письмо сообществу!?

[Forumsky]

Неужели из 419 пользователей, зареганых на форуме не найдётся несколько человек, готовых понемногу продвинуть вопрос документации?

[pachanga]

Ещё зендовский мануал меня лично вполне устраивает: http://framework.zend.com/manual/en/
Они делают документацию через http://docbook.sourceforge.net/ похоже что он и используется на http://php.net
То есть мне кажется что кроме самого содержания документации, стоит уделить внимание на чём она пишется.

Вообще, в конечном итоге наиболее правильно, конечно же, вести документацию в подобном виде и хранить ее в репозитории, а не в wiki с периодической публикацией в web. Но мне даже сложно предположить, кто возьмется за перенос того, что есть в wiki, в docbook(или нечто подобное).

В общем проблема документация очень важная: получается что функционал есть, а пользоваться им могут очень не многие, то есть эффективность низкая. Может организовать рабочую группу по этому вопросу, добавить блок на главную страницу, написать письмо сообществу!?

Сообщество все сидит в форуме Вот, например, ты лично готов как-то поспособствовать развитию документации?

[Forumsky]

Вообще, в конечном итоге наиболее правильно, конечно же, вести документацию в подобном виде и хранить ее в репозитории, а не в wiki с периодической публикацией в web. Но мне даже сложно предположить, кто возьмется за перенос того, что есть в wiki, в docbook(или нечто подобное).

Интересно, в том же ZF как это организовано? А в остальных open source? Ну кто то же должен этим заняться.

Сообщество все сидит в форуме

На форуме сидит сообщество, которому более менее что то ясно. А новичкам где сидеть? Хотелось бы ответить -- в доках ....

Вот, например, ты лично готов как-то поспособствовать развитию документации?

Мне самому тошно, что я в основном только на форуме и болтаю, а ничего реального не привнёс. Да, я готов лично поспособствовать.

[korchasa]

Предлагаю подумать над следующими вещами:

• wact - 3 ошибки. ИМХО, стоит поправить
• log - нет тестов. Надо дописать
• zfsearch - нет тестов. Оно нам надо?
• scripts - нет тестов. Оно нам надо?

Предлагаю не только подумать, но и сказать что-нибудь. Иначе, если это никого не волнует, буду решать как написал. Добавилось еще и то, что не проходят тесты на cache (вся работа с APC). Предлагаю переместить в инкубатор, если никто чинить не хочет, и есть замена.

[wIliaM]

Предлагаю подумать над следующими вещами:

• wact - 3 ошибки. ИМХО, стоит поправить
• log - нет тестов. Надо дописать
• zfsearch - нет тестов. Оно нам надо?
• scripts - нет тестов. Оно нам надо?

Предлагаю не только подумать, но и сказать что-нибудь. Иначе, если это никого не волнует, буду решать как написал. Добавилось еще и то, что не проходят тесты на cache (вся работа с APC). Предлагаю переместить в инкубатор, если никто чинить не хочет, и есть замена.

ИМХО, все правильно написал.
zfsearch и scripts пока без тестов поживут.
про APC и cache немного не понял. т.е. не работает APC-драйвер пакета cache2. все остальное работает?
если так - то по хорошему надо починить APC, правда хз чьими руками.

[korchasa]

ИМХО, все правильно написал.
zfsearch и scripts пока без тестов поживут.

scripts оказался набором скриптов для сопровождения, и я его переместил выше, в 3.x. zfsearch я хочу переместить в инкубатор.

про APC и cache немного не понял. т.е. не работает APC-драйвер пакета cache2. все остальное работает?

APC не работает в cache.

[korchasa]

Добавил страничку http://wiki.limb-project.com/doku.php?i ... umentation с проблемами в документации.

Вики позволяет получить список мертвых ссылок?

[pachanga]

Э...сомневаюсь