wiki.joostina.ru

[Gold Dragon]

Предлагаю в Вики сделать отдельный раздел где будут собираться описание классов.
Например, можно по такой схеме

- Название - описание
- Размещение
- Переменные
- Функции
- примеры использования

[smart]

Хм, по хорошему эту информацию нужно генерировать автоматически с помощью phpDocumentator, как это сделано на api.joomla.org

[Gold Dragon]

а что генерится в итоге? Понятного и "русского" описания всё равно не получится

[smart]

а что генерится в итоге? Понятного и "русского" описания всё равно не получится

А это зависит от того, какие комментарии в коде, если они будут русскими и понятными - все будет по-русски и понятно.

[Gold Dragon]

в принципе получится тоже на тоже + ещё и дополнительно править.. Комментарии точно не на русском и даже за частую не на английском.. По мне лучше потихоньку создавать справочник

зы
понятно что разработчики это знают, а пользователям это не нужно Но если бы это было, то новые компоненты были более капризные

[smart]

Да нет, лучше сразу документировать код, и потом автоматически получать документацию. Чем иметь код и потом следить за актуальностью этой документации. Вот смотри, добавили новую функцию - прокомментировали - она уже есть в документации. Завтра заменили 2 параметра, подправили тут же комментарии - на утро на сайте автоматически уже есть актуальная документация. И никакой ручной правки - все сразу есть. И чего нет - тоже сразу видно.

[Gold Dragon]

ну вообще-то может ты и прав, но всё же описание не совсем то что я думаю..

Я вот тут попробовал сделать пробную страничку.. Я ещё не работал с Вики, так что как получилось

http://wiki.joostina.ru/MosTabs

[boston]

phpDocumentator не очень корреткно относится к неУТФ колдировкам. А Joostina до выхода стабильной 1.3.0 не совсем юникодовая

К тому же не все функции описаны и данные о них актульаны...

Но затея ясна, будем думать чего порешать

[Gold Dragon]

boston, давай думай пока запал не пропал

[ZHart]

Gold Dragon, так а чего думать-то?
wiki на оф. сайте открыта для всех, так что если есть желание работать в этом направлении - милости просим, все только спасибо скажут
Хотя конечно в данном случае потребуется участие разработчиков, так что возможно все-таки придется дождаться окончательного ответа boston-а...

[Gold Dragon]

ну так я так и буду делать я только попросил отдельный раздел для этого.. Сейчас это в "Техническая документация" Но это малость не правильно, нужно хотя бы подраздел сделать, чтоб навигация была логичной ..

[ZHart]

Gold Dragon, отписал в личку.

[Gold Dragon]

я уж тут отпишусь.. может у кого идеи другие будут...

В принципе я думал совсем простую структуру, т.е. создаётся подраздел "Классы" в разделе "Техническая документация", а там создавать страницы самих классов

[ZHart]

Ну высказывайтесь, если никто не будет против и не будет других идей - создам подраздел "Классы".

[boston]

Hammer, проследи пожалуйста за темой. для меня WIKI немного далека, и на форуме не получается постоянно мониторить

Gold Dragon, супер! Спасибо большое что участвуешь в таком полезном моменте!

[Andros]

Ребята, давайте поднажмем на wiki... Есть предложение: например, если у кого-то есть вопросы, которые он хотел бы видеть в разделе FAQ или WIKI, но не знает ответа, то может подготовить хотя бы оглавление по данному вопросу. Для примера можете пройти сюда

[Gold Dragon]

да я бы с удовольствием загонял в Вики всё что нахожу и в ФАКах и на форумах, вот только сам сайт http://www.wiki.joostina.ru/ постоянно в дауне

[ZHart]

Gold Dragon, вылеты временами случаются, но не так уж постоянно, работать в принципе можно.
Обращение ко всем: если все же приключаются какие-то проблемы или сложности - пишите в эту тему или мне в личку, будем решать.
wiki однозначно хорошо бы заполнять поактивней, все желающие - подключайтесь пожалуйста, не стесняйтесь.

P.S.: Тему прикрепил.

[temniy]

wiki однозначно хорошо бы заполнять поактивней, все желающие - подключайтесь пожалуйста, не стесняйтесь.

Её бы, имхо, открыть для гостей хорошо бы... а то регистрироваться не каждый захочет, чтобы пару предложений написать.

[ZHart]

Гостям открыть дело нехитрое и нежалко, только вот думается мне - захлебнемся в спаме.
Было дело, вычищали спам даже от зарегистрированных пользователей.
Что будет, если открыть ее для гостей?

[temniy]

Гостям открыть дело нехитрое и нежалко, только вот думается мне - захлебнемся в спаме.

а навесить kcaptha? автоматы отсечем, а злонамеренных много быть не должно, а то и вовсе не будет.

[ZHart]

Можно попробовать. temniy, знаешь хороший плагин капчи для MediaWiki? Или можно стандартным функционалом обойтись?

[Andros]

да я бы с удовольствием загонял в Вики всё что нахожу и в ФАКах и на форумах, вот только сам сайт http://www.wiki.joostina.ru/ постоянно в дауне

Сколько раз был, ни разу в дауне не наблюдал

[temniy]

Не, медиавику не люблю. А kcaptсha прикрутить же не сложно, зачем плагин. По моему мнению - лучшей защиты от ботов нет (из капч).

[Gold Dragon]

Andros, тебе везло

кстати, согласен с temniy, мне тоже не очень нравится wiki, достаточно запутанный интерфейс если не пользоваться поиском , но другой альтернативы трудно найти.. легче привыкнуть

[Gold Dragon]

опять постоянно в дауне сайт
и ещё это

Notice: Undefined index: category in /var/www/vhosts/joostina/wiki.joostina.ru/www/extensions/articletocategory.php on line 26
Notice: Undefined index: new in /var/www/vhosts/joostina/wiki.joostina.ru/www/extensions/articletocategory.php on line 27

[Gold Dragon]

у меня вопросик... Я то вот пишу потихоньку в Вики, но я не разработчик и могу просто не знать "стандартов" Joostina, например, стандарт XML компонента/модуля/шаблона... Как быть с такими моментами?

[Gold Dragon]

есть тут кто-нибудь или как? А потом ещё говорите что нет желающих

я вот не могу создать новую статью. Вот такая ошибка

Notice: Undefined index: category in /var/www/vhosts/joostina/wiki.joostina.ru/www/extensions/articletocategory.php on line 26
Notice: Undefined index: new in /var/www/vhosts/joostina/wiki.joostina.ru/www/extensions/articletocategory.php on line 27

Иногда проглатывает, но сегодня никак не хочет

[ZHart]

Я тут есть, но честно говоря по стандартам для разработчиков точно не проконсультирую, тут луче бы Коля объяснил или еще кто-то из непосредственно разработчиков. Надеюсь, в ближайшее время ответят.

По работе wiki - только что проверил - никаких ошибок не выдает, работает нормально.
Попробуй пожалуйста еще разок.

[Gold Dragon]

выдаёт ошибки при создании новой статьи.. Низа вообще нет.. страницу просто обрезает. Проверял и в Осле и в Лисе. Т.е. Нет кнопки СОХРАНИТЬ