Страница 2 из 3

Re: Документация по jQuery

СообщениеДобавлено: 16 май 2011, 23:38
zandroid
Я согласен, что на вики должно быть больше информации, чем только перевод, но не надо превращать описание функции в какую-то статью, по конкретной функции информация должна быть короткой, чёткой и понятной, с примерами, возможно, с демками (как на оф.доках), а уже на других страницах можно подробнее описать и подводные камни, и особенности и пр. и на эти страницы просто дать ссылки под коротким описанием функции. Иначе просто нет отличий вики от блога, а блог у нас уже есть.

Можно закрыть регистрацию на вики, а новых пользователей добавлять сможет только администратор(ы) вики. И разрешить править материал только зарегистрированным пользователям. Тогда будет, примерно, то, что ты описал.

Re: Документация по jQuery

СообщениеДобавлено: 16 май 2011, 23:49
Gennady
XelaNimed писал(а):ведь в первую очередь, как мне видится, документация должна снять большинство вопросов на форуме тем самым "разгрузив" его


Да в общем документация (в том виде как есть на оригинальном сайте) и снимает большинство вопросов... Остаются вопросы сложные, нестандартные и если можно так выразиться, вопросы по алгоритмам решения задач. Это в идеале конечно. Реально - большинство вопросов, задаваемых на форуме (думаю не только на этом) происходит от невнимательного изучения документации. Основная причина - языковой барьер. Так что даже перевод - уже хорошо. Если уместно будет что-то более того - почему нет?

XelaNimed писал(а):Вполне очевидно, что возложить все заботы по созданию на небольшую группу людей не пойдет, но и позволить всем - тоже не вариант.

Полностью согласен, как согласен и с предложением добавлять желающих поучаствовать в этом деле. Но это можно и по ходу дела решать.

З.Ы. Кстати, у нас как-то безальтернативно пошел разговор именно про использование wiki-среды. Может быть еще какой-то альтернативный вариант?

Re: Документация по jQuery

СообщениеДобавлено: 16 май 2011, 23:58
XelaNimed
zandroid, как бы не хотелось превращать описание в статью, но даже при переводе официальной документации получается довольно большой объем информации.
Gennady, ну а "своё" создать, это потребует большого количества "человекочасов"?! В принципе главное удобная навигация и удобный способ добавления информации.

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 09:15
Gennady
XelaNimed писал(а):Gennady, ну а "своё" создать, это потребует большого количества "человекочасов"?! В принципе главное удобная навигация и удобный способ добавления информации.

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


XelaNimed писал(а):zandroid, как бы не хотелось превращать описание в статью, но даже при переводе официальной документации получается довольно большой объем информации.

Имхо, не стоит пока особенно морочиться этими вопросами - склоняюсь к мнению zandroid'a, что если делать это, то по сути перевод документации, как он есть на оригинальном сайте (или по крайней мере близко к этому). Ведь главная ценность не в этом - важнее, что в информацию должны будут оперативно вноситься изменения. Если же будет, что добавить интересного от себя - то почему бы и нет...

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 09:33
Gennady
По-моему все нормально получается:
- блог - статьи про новые технологии, или например какие-то интересные решения и проч.
- форум - помощь в решении конкретных вопросов, обсуждение сложных и/или нестандартных задач
- вики - просто документация, но документация обновляемая

Имхо, все по логике ;)

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 09:43
zandroid
Gennady писал(а):По-моему все нормально получается:
- блог - статьи про новые технологии, или например какие-то интересные решения и проч.
- форум - помощь в решении конкретных вопросов, обсуждение сложных и/или нестандартных задач
- вики - просто документация, но документация обновляемая

Имхо, все по логике ;)

Да, и альтернативу вики тут уже сложно предложить, потому что уже есть блог. А в вики основная ценность (помимо совместного создания контента) в её поиске - ввел имя функции и тебя сразу на страницу с описанием перебросило и в большинстве случаев не надо перебирать результаты поиска.

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 11:18
XelaNimed
zandroid писал(а): ... ввел имя функции и тебя сразу на страницу с описанием перебросило ...

Может все таки с ЧПУ это организовать?! ИМХО удобней было бы, да и в поисковые движки себе можно было бы добавить...

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 11:31
zandroid
XelaNimed писал(а):
zandroid писал(а): ... ввел имя функции и тебя сразу на страницу с описанием перебросило ...

Может все таки с ЧПУ это организовать?! ИМХО удобней было бы, да и в поисковые движки себе можно было бы добавить...

Ещё раз настоятельно рекомендую посмотреть на википедию - она работает как раз на медиавики, в сторону который мы все и смотрим, чтобы не задавать вопросов, ответы на которые очевидны. В википедии как раз ЧПУ и работают, вообще это один из принципов вики-среды, что URL формируется по названию (как правило, заголовку) страницы, и именно поэтому и перебрасывает на нужную страницу при вводе заголовка в поиске, именно на этом и построена навигация по вики-сайту.

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 12:39
Gennady
Думаю, что нам придется все-таки смотреть в сторону именно DocuWiki. Мне она показалась более простой, легкой и более подходящей для небольшого проекта, каким без сомнения является перевод документации по jQuery. А что без БД, так это может быть и плюсом. Все-таки MediaWiki - это "монстр", который более подходит для широкомасштабных проектов... По крайней мере такое впечатление сложилось у меня после того, как я на локалке попробовал и то и другое.

P.S. Zandroid, ты вроде бы упоминал, что с DocuWiki сталкивался... Я пока там "плаваю"... Основные принципы конечно понятны, но пока фиговато - надо поюзать, почитать. Я имею ввиду как раз создание нормальной структуры и т.п. Потерзаю ее на локалке еще немного, а потом на сервер брошу и вместе глянем.

Re: Документация по jQuery

СообщениеДобавлено: 17 май 2011, 13:01
zandroid
Gennady, я с тобой согласен по поводу мощности медиавики. С докувики, да, было дело, немного работал, не знаю есть ли смысл сейчас сильно заморачиваться там на структуру (если ты про структуру вики-сайта), как я уже писал, структура отходит на второй план в вики системах, там статьи должны быть в первую очередь доступны по заголовку при быстром поиске.