В последнее время всё чаще встаёт вопрос о необходимости создания "нашего" оверлея ebuild'ов Gentoo. Так зачем он нужен, когда существует проект Sunrise и связанный с проектом оверлей? Попробую этой заметкой развеять часть мифов о sunrise и пояснить, как получить туда доступ. Вернее, я хочу развеять один миф о том, что "туда сложно что-нибудь добавить".
Что такое Sunrise?
Sunrise это проект, который предоставляет оверлей для пользователей и разработчиков. Цель оверлея двояка - с одной стороны предоставить пользователям доступ к ещё большему количеству пакетов, с другой, позволить пользователям поддерживать пакеты. То есть Вы можете самостоятельно поддерживать желаемые пакеты! При этом пакеты в оверлее должны удовлетворять определённому уровню QA.
Как использовать пакеты из оверлея?
Чтобы получить доступ к пакетам из оверлея вам потребуется установить layman и добавить оверлей:
emerge -va layman layman -f -a sunrise echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf
Так как же получить доступ в оверлей sunrise и поддерживать там пакеты?
Вы написали ebuild и хотите получить доступ в оверлей чтобы добавить туда пакет. Сделать это очень просто! Для этого Вам нужно:
Всё! Разве возможно сделать проще?
Обычно проверка ebuild'а занимает от 10 минут до 2х дней. Всё остальное зависит только от Вас.
Кроме этого, если вы испытываете сложности с английским языком, вы можете обратиться на русском языке к разработчику Gentoo pva либо на канале #gentoo-ru, либо отправив личное сообщение в IRC клиенте, либо используя Jabber.
Не забудьте, что вас обязательно попросят прочитать документ, о там как отправлять ваши файлы в хранилище:
http://overlays.gentoo.org/proj/sunrise/wiki/HowToCommit
И прежде, чем давать пароль, вам будут задавать вопросы по этому документу. Поэтому, чтобы не отнимать времени у разработчиков больше, чем требуется, сразу прочитайте его внимательно.
Есть вопросы? Почитайте FAQ и другую информацию на страницах проекта.
Успехов!
Комментарии
Не все так замечательно
1) У девелоперов не всегда хватает времени на проверку ебилдов.
2) Не все могут общатся по-английски
3) А некоторые, принципиально, этого не любят
4) Русских девелоперов в онлайне может и не быть, а ждать у моря погоды можно долго
5) Ебилды ориентированные только на русских в офф. дерево не пропустят никогда (ровно как и в санрайз) (случай с man'ом, хотя там, имхо, вообще параноидальный маразм отдельного девелопера).
6) Людям хочется иметь свой оверлей. У немцов, японцев, китайцев и тайваньцев свой оверлей есть, видно им не показалось, что "плодить сущности" - это излишне
7) Генту.ру тоже нужны девелоперы. Которые будут переводить документацию, оказывать помощь соотечественникам, возможно стоит поднять даже русскую багзиллу - в первую очередь людей отпугивает требование писать на чужом языке (да и не всегда это просто объяснить толком, а корявые объяснения девелоперам разбирать некогда)
8) Наш отдельный "санрайз" (или просто gentoo-ru) попросту немного разгрузит оффициальный. Возможно, по договоренности с девелоперами санрайза, можно будет делать переодическое слияние деревьев (тех, чьи не затрагивают только русских), а особо отличившихся девелоперов отсюда агитировать на работу с оригиналом.
З.Ы. Да, и про багзиллу это я не просто так сказал - было бы очень неплохо ;)
Эм-м-м... Это кто
Эм-м-м... Это кто будет переводить русскую багзиллу на английский? Или кто будет эти ошибки исправлять? А иначе какой смысл в ней? Разве что для документации...
Пожалуйста, не описывайте своё железо в подписи
Текстовый редактор vi имеет два режима работы: в первом он пищит, а во втором — всё портит.
Русский
Русский санрайз нужен для получения русских девелоперов, которые и будут исправлять баги (либо выяснять причины ошибки), либо просто перепостивать в английскую багзиллу.
З.Ы. Багзилла всяко нужна для оверлея. Без багов не обойдемся, да и пожелания тудаже. + Пожелания по сайту и прочая. Багзилла нужна, а ее функции определятся временем, имхо
было интересно
было интересно взглянуть на все это ))
...
Лично вы готовы на более менее разумны срок, скажем года на три, подписаться на такую работу? А если вы научитесь фиксить баги, разве у вас не появиться желание коммитеть фиксы сразу в официальное дерево?
Потом сложно учиться глядя со стороны - неизбежно начинаешь переизобретать велосипед. Не лучше ли учиться сразу у разработчиков?
На тех же
На тех же условиях, что англ. девелеры - да готов.
Нет, не захочется. Не люблю буржуев, пускай с ними кто-нить другой общается =).
...
Вы пробовали или просто так здесь ноете? Люди которые всегда (!) висят в #gentoo-sunrise утверждают, что на это уходит от 10 минут до 2х дней. А если вас достанет ждать, заполните ebuild quiz и коммитьте сами, без проверки! Кто за ВАС будет делать работу?
я говорю по русски, обращайтесь ко мне, не зря же я здесь воздух сотрясаю.
Ок. Пишите мне на почту. Только, не забывайте проверять devaway, когда ожидаете быстрого ответа. Но лучше меня искать на канале #gentoo-ru. Я почти всегда когда у компа, там нахожусь.
А конкретные примеры привести удосужитесь? И что за случай с man'ом? Если по поводу перекодировки страниц в utf-8 с помощью iconv, то это не решение проблемы, а избегание оной. Предложите решение! И если хотите это обсудить, делайте это в баге и можете CC меня туда, а не здесь. В этом топике я удалю подобный оффтопик.
Где у немцев оверлей? У Японцев другая история, им для отображения их иероглифов нужны хитрые патчи на freetype и подобные вещи, которые иногда портят написание обычных букв. Поэтому этого нет в дереве, а лежит в оверлее.
Именно! Русскоговорящие разработчики нужны! Их катастрофически мало, но они есть! Проблема в том, что gentoo.ru стоит отдельно от gentoo.org, и поэтому разработчики, которые знают Gentoo и действительно исправляют ошибки, редко доходят сюда... Точно такая же проблема была у товарища из Германии. Почитайте, пожалуйста:
http://archives.gentoo.org/gentoo-dev/msg_ab4d83720e880c1644a86e5685dd4a0a.xml
и ответ
http://archives.gentoo.org/gentoo-dev/msg_e1b340b0f6632a0a4242daae4b16b927.xml
Думаю, теперь вы понимаете, почему gentoo.de лишь даёт ссылку на немецкий форум gentoo.org. Нам уже от этого форума не уйти, но не надо ещё больше усугублять положение.
Вы забываете, что все разработчики Gentoo являются энтузиастами и пришли из сообщества. Сообщество является движущей силой Gentoo. Если вы "растащите" разработчиков по оверлейям, а баги по багзилам, то к чему это приведёт? Две багзилы это плохо ибо чтобы найти что-либо придётся тратить в два раза больше времени, и что делать тем, кто не знает русского языка? Как понять, почему был сделан тот или иной коммит? Или, если вы полагаете, что русскоязычные разработчики должны быть отдельно от mainstream'а? Тогда какой толк от их работы если они не смогут коммитеть изменения. Просто переводить баги на английский язык? Много вы найдёте желающих делать такую работу? Обратно то найти не просто.
Проблема языка существует, и её надо решать, только я не знаю как. Скорее, на данный момент опять же, сообществу (то есть Вам) русскоязычных пользователей нужно помогать тем, кто не знает языка. Вы видите сообщение об ошибке на форуме, вы можете её воспроизвести и это действительно баг в дереве. Создайте отчёт об ошибке! Только так, лично своей активностью вы можете помочь...
Сейчас я уже официальный разработчик sunrise. Вливайте свои ebuild'ы сразу в sunrise! Или вы хотите делать одну и ту же работу дважды?
> Где у немцев
> Где у немцев оверлей?
% layman -i gentoo-de
* gentoo-de
* ~~~~~~~~~
* Source : rsync://rsync.gentoo.de/gentoo-de-ebuilds
* Contact : bugs.gentoo.de
* Type : Rsync; Priority: 50
*
* Description:
* ebuild overlay managed by german gentoo users
*
* *** This is no official gentoo overlay ***
*
:)
:)
gentoo.de
Ага, но разве ж это оверлей? Специально связался с немцами, вот ответ разработчка
Ещё раз Conclusion: Use sunrise for new stuff.. Так что думайте сами оверлей это или наследие истории ;)
Вы не знаете как решать, дык послушайте что я предлагаю
Я не претендую на абсолютную истину в последней инстанции, я предлагаю подумать над другими вариантам, окромя "всем дружно строем учить английский". Поскольку лично вы, да и остальные с кем я говорил, никакого решения "языковой проблемы" не предложили, то послушайте хотя бы мою. И, пожалуйста, не стоит обращатся как мне как в "сепаратисту" и "врагу коммьюнити", моей целью является увеличение комьюнити, а вовсе не "растаскивание".
По порядку: Я думаю никто не будет спорить, что русское комьюнити малоразвито? С переводами просто беда. А почему? Мало людей. А почему мало людей?
На мой взгляд (основан на общении с человеком, очень плохо знающим английский и ниразу не видевшего линукс, но желающего попробывать):
- На сайте gentoo.ru нету... абсолютно ничего, кроме форума. Ни толкового описания дистрибутива, ни документации, ни хендбука, ни-че-го, что помогло бы человеку выбирающему дистрибутив, сделать выбор в пользу gentoo. Человек заходя на сайт gentoo.ru видит тока ссылки на gentoo.org. А gentoo.org по-английски, и даже чтобы найти русский хендбук (старый! который просто так хрен найдешь)... нужно знать английский! или попросить кого-нить ссылку. Большинство информации - на английском.
- Когда у человека возникает проблема за пределами его кривых рук (ака "баг"), то на что расчитывает этот человек? На то, что он может рассказать о своей проблеме кому-нибудь разбирающемуся в этой тематике и он придумает решение. Вот только проблема - он должен сделать это на чужом языке. А это не всегда просто, даже для человека неплохо знающего английский. Как результат - у большого количества русскоязычного населения нет русской поддержки. Нужна поддержка - вот вам форум, а если тут не помогли - ну... идите лесом.
Что, на мой взгляд стоит сделать на сайте (и зачем) (имхо, проще всего стянуть движек gentoo.org):
1) Список русских мирроров - их много, но в офф. списке их нет, т.к. либо просто заявки не подавали, либо не удоволетворяют требованиям. Для небольшой части комьюнити требования можно понизить, будет достаточно, а список собрать не только по заявкам, а таже кто что знает.
2) Движок обработки документации - лазить на англоязычный сайт за русской документацией - это маразм. gentoo-wiki - это хорошо, но неочевидно.
2б) Перевести хендбук и сделать его перевод максимально приоритетной задачей.
3) Создать багзиллу - для организации внутренних нужд. Если вы так против дублирования багов (об этом ниже), то она все равно нужна для трекинга ошибок в переводах, сайте, отслеживания активных мирроров, а также багов из оверлея.
4) Сделать ссылку с русских форумов gentoo.org на форум gentoo.ru (а не наоборот) (это и так в процессе, как я понял)
5) Сделать свой оверлей для специфичных ебилдов.
6) Сделать свои стейжи и диски (на основе оригинальных) с поддержкой русской локали на инсталяционных cd/dvd и установленным пакетом программ (и настроек по умолчанию) необходимых для русской локали в стейжах (возможно и с приделанным сразу русским оверлеем, если таковой таки будет).
Главное - русским разработчикам намного приятнее работать на русском языке. Связь с мейнстримом терять ни в коем случае нельзя - этим должны заниматся люди которые знают хорошо английский и русский и готовы быть координаторами.
А теперь по-пунктам:
1,2 - думаю не вызывает сомнений, что надо? Особенно 2б.
3 - объяснение в описании. Это просто полезнее и удобнее (имхо) чем форумные аналоги.
4 - два форума - это бред, а как показывает практика, люди ищут русский форум на сайте русского сообщества, а вовсе не на англоязычном сайте.
5 - оверлей нужен, и я описывал зачем. Да, для специфичных для русского хаков и workaround'ов. Да, "случай с man'ом" это то самое кодирование при помощи iconv _из_ utf8 в язык локали пользователя в режиме реального времени, а не во время компиляции. И какого, простите, хрена люди должны ждать годы решения подобных проблем только из-за того, что у апстрима нет багзиллы, а ментейнер попросту забыл? Именно в русском оверлее никому, имхо, не помешают специфические хаки для поддержки русского языка.
Зачем нужен "sunrise-2"? Вопрос конечно спорный, и требует обсуждения, но, в основном, по тем же причинами что и выше - людям приятнее работать на своем языке. А упомянутый выше devaway, который неплохо бы проверять, на каком?
Совсем необязательно делать sunrise-2, можно сделать sunrise-ru, который, в последствии будет вливатся в sunrise (без проверки). Просто общение будет на русском, а не на английском. Можно общатся и сейчас говорите? Пока что, вы единственный кто предложил проверять на русском, а если все начнут постить в санрайз, да еще и выростет комьюнити - вы один справитесь? А от админов русского sunrise'а вовсе не нужно будет требовать хорошего знания английского, поэтому, наверняка, делать эту работу смогут больше людей.
Вообще, главная задача оверлея - это кузница кадров. Русскому комьюнити нужны люди которые будут переводить, но переводить надо не только документацию. Надо переводить portage, man'ы, надо перевести документацию по ebuild'ам (которую и на оригинале-то хрен найдешь). На данный момент каждый девелопер на gentoo.org делает, по сути, что он хочет. Это можно делать и не зная английского, результат будет тотже. Вот только стать девелопером для человека не знающего английский невозможно. А некоторые, просто не хотят работать на английском. Я, к примеру, готов помогать и исправлять ошибки, но только по-русски. Я готов, если мне предоставят инструмент (движек), перевести хендбук, также способен занятся переводом portage, baselayout (типа net.example) и man'ов. Мне, также кажется неплохой идея перевода описаний к опциям ядра (очень поспособствует их пониманию), я готов занятся и этим. Но этож надо куда-то коммитить - переводы программ, тож в санрайз предлагаете чисто русские ебилды?. На багзилле лежат несколько моих ебилдов, (к примеру: dns-сервер nsd и веб-форум unb), которые уже с пол-года висят на Mantainer Wanted. Я смог бы стать их ментейнером (учитывая, что я использую и то и то), но тока у меня нет желания становится для этого английским девелопером. Запостить в sunrise? А толку? Оно так в санрайзе и будет висеть, пока мейнтейнера не будет, это все равно что багзилла. Русский же оверлей можно использовать как предварительную ветку официального дерева - так делается на kernel.org - многие патчи коммитятся в дерево for-linus, а потом лично Товальдсом мержатся в основную ветку.
Насчет багзиллы-2: Обычным пользователям нужна поддержка на своем языке. Никакой поддержки от 3 русскоязычных девелоперов им не будет. Если же девелоперов будет много. пусть и не оффициальных, то, при толковой координации (в данном случае при договоренности о упрощенной системе проверки, чтобы не делать одну работу дважды), это может неплохо помочь и gentoo.org, которые уже просто захлебываются и не справляются с тем потоком багов, который на них выливают.
Куча пользователей просто не выбиратют генту из-за того, что нету нормального объяснения что это за зверь Gentoo и с чем его едят... А потом юзают всякий шлак типа мандривы или альт-линукса, которые озаботились созданием нормального русского сайта и русской поддержки.
Возможно несколько невнятно и сумбурно - однако просьба не растаскивать это на куски и пытаться понять как единое целое. Если есть вопросы - я готов к обсуждению.
Я не девелопер,
Я не девелопер, времени не хватает, но баги ловить получается хорошо и отсутствие места куда можно про них накатать по-русски сильно осложняет дело. Чаще всего приходиться терпеливо ждать пока ктонибудь тоже споткнётся и выложит баг на английскую багзиллу, и потом следить за темой, выдирать патчи/ebuild и собирать в локальном оверлее.
Рускоязычный санрайз нужен, и должен синхронизироваться с оригинальным, для специфичных сборок флаг linguage_ru никто не отменял, ИМХО здесь нет проблемы.
"..надо перевести документацию по ebuild'ам .."
плюс необходим справочник по eclass, но походу это мечты несбыточные. Хотя можно скриптом пройтись по каталогу и выдрать описания функций, а потом потихоньку перевести.
Есть доки по eclass'ам. Тока их, как обычно, хрен найдешь.
Они есть... Тока я найти не могу, щас... О (g site:gentoo.org): http://devmanual.gentoo.org/. Там не все еклассы, но какие-то есть. Это-то и надо перевести, а то что в хендбуке- там слишком мало.
+1
Со временем и у меня не очень, а переводы доков и информации по багам делать хочу и могу. Да и с их исправлением помогать. Хотя это и не сложно на данный момент, но языковой барьер также имеет место. С пол года назад подписался на русскую рассылку, но разобраться как постить переводы и так далее просто нет времени.
Очень хочется получить вменяемый способ постить свои наработки.
Касательно переводов, может что нибудь на подобие вики - по моему хороший вариант?
Так же поддерживаю размещение документации к дистру на gentoo.ru
На мой взгляд оверлей не должен быть самостоятельной сущностью, а промежуточным этапом перед портэжэм с обратной связью. Что типа тестовой ветки. Тогда и мэинтейнерам будет проще вводить в дерево новые ебилды, и сообществу проще оказывать им поддержку и самим входить в их число. Да и багов поуменьшиться.
Как то сумбурно получилось, ну да ладно. Вроде всё, что хотел, сказал
...
Я отвечаю за переводы и могу сказать, что в этой области есть прогресс и думаю мы скоро возобновим процесс перевода. Если интересно, в чём история вопроса почитайте последние письма в gentoo-doc-ru, где я описывал проблемы и пытался найти решение. Сейчас решение найдено и хотя не то, что я предлагал скоро мы увидим как оно работает...
Да! И это то, что нужно менять... И ИМО причина этому, что была надежда поднять новые клёвые сервисы, а люди сами подтянуться, будут делать разные проекты и всё САМО заживёт. На деле, если лично вы не готовы день ото дня работать забесплатно, то мало что движется.
И проблему с языком я понимаю. Именно поэтому я взялся помогать вам и готов на русском языке объяснять вам ошибки в ebuild'ах.
А можете ли вы пояснить, почему вы думаете, что зеркала, которые не удовлетворяют минимальным требованиям быть актульными стоит советовать к использованию? Ведь сколько раз было, что админы, просто забывали про зеркало и оно безбожно устаревало... И если синхронизироваться то с этим зеркалом, то с другим, получается куча уходит зазря трафика... Кроме того вы подумайте над безопасностью, ведь ненадёжное Васино зеркало может вам дать "отличное" обновление coreutils с незаметным backdoor'ом...
Про переводы я писал и надеюсь это измениться скоро... а ссылку на wiki может быть стоит дать... Вопреки общему мнению разработчиков Gentoo, которые считают, что wiki - порочная система, я думаю, что все уже большие и могут критически относиться к написанному в wiki.
Это уже есть и это нужно. Под переводы оно будет сейчас затачиваться и как только мы проверим всё что нужно, опишем как и что делать будем пытаться по новой запустить перевод. Благо есть люди желающие это делать...
Нет, пока это просто идея. И делать я это буду только когда пойму, что здесь сообщество Gentoo, которое помогая новичкам, выращивает продвинутых пользователей и будующих разработчиков, а не фан клуб... Просто иначе мои усилия будут без смысленны для Gentoo.
Вы так и не ответили на вопрос каких именно ebuild'ов?
Сейчас процесс производства выпусков будет изменён и есть идея строить выпуски непрерывно. поэтому будет не сложно сделать livecd с эмблеммой gentoo.ru. Я за эту идею, только бы найти лого... ;) Но локаль русская должны быть в официальных liveCD/DVD и вроде она там есть...
К сожалению это сложно сделать, если хотя бы не читать по английски... Разработчики вынуждены учить язык. Вот пользователи это другая история и для них нужно сделать всё, чтобы они могли комфортно существовать без знания языка. Но это не значит, что на занятия таким пользователям. Всегда можно "вычитывать" ошибки в переводах, есть творческие люди, которые хорошо рисуют. Они могут это делать не зная языки и они нужны, а зачастую даже очень.
Хм, ок, возможно это решение. Посмотрим, что upstream скажет...
Справлюся я или нет, пока сложно сказать. Пока справляюсь, никто не пишет нигде, кроме как в рассылке да здесь и то не по делу :) В будующем, я надеюсь увидеть в своём окружении научившихся людей, которые смогут писать нормальные ebuild'ы и смогут стать разработчиками и тоже проверять ebuild'ы. Это единственный путь.
А про админов русского sunrise... Я пока не вижу никого, кто бы поднатарел в проверке ebuildов настолько, чтобы делать это эффективно... Как только поднатареют, в чём проблема им тоже присоедениться к sunrise?
Согласен это одна из очень важных задач оверлея. Именно поэтому, пока русских разработчиков мало, он должен быть один - sunrise, а если много, то тоже sunrise :) Но какое к оверлею имеют переводы?
Именно, ибо даже если предположить, что всё, что возможно перевели, вы не можете общаться в интернациональной среде...
Отлично. Для перевода знание русского языка является более выжным, чем английского. Поэтому если вы готовы методично переводить, то я очень надеюсь увидеть вас в команде переводчиков, которую скоро мы будем пытаться ввостановить. Кстати, инструмент перевода - это ваш любимый текстовый редактор, который понимает utf8.
Ух, а что это такое??? Что то типа:
наследовать ефункции ОПИСАНИЕ="Первый в мире русский ебилд" ДОМАШНЯЯСТРАНИЦА="http://gentoo.ru" КЛЮЧСЛОВА="амд64 х86 спарк" ЗАВИСИМОСТИ="" СЛОТ="0" код_установить() { делай НАЗНКАТ="${Д}" установка || умри "сборка провалилась" }Это смерть ;)
Идея в том, что вы можете поддерживать пакеты в sunrise, а у sunrise уже много пользователей... Поэтому вам не нужно столько учиться, сколько разработчику, вам разработчики помогут, при этом желаемые вами пакеты будут в оверлее и пользователи будут их использовать.
Это практически не возможно. По крайней мере пока gentoo.org не перейдёт на git. Потом изменения в дереве зачастую затрагивают слишком много всего, например, eclass и все ebuild'ы наследующие eclass. Например, я так делал со startdict'ом. Первое изменение eclass'а было временное, позволяющее работать и старым и новым ebuild'ам, но оно было скорее хаком, после этого я изменил все ebuild'ы в дереве и изменил ещё раз eclass. Теперь все ebuild'ы не переписанные под новый eclass сломаны... Я могу посмотреть (и смотрел) на sunrise и пару ещё других оверлеев, но не возможно отследить всё. Поэтому меньше оверлеев - меньше пользователей со сломанными пакетами...
Может быть. Поймите мой вопрос. Зачем становиться неофициальным разработчиком? Если у вас достаточно знаний, станьте официальным и помогайте здесь, на форуме, пользователям! В чём радость от того, что вы что-то делаете, но не имеете возможности "сохранять" свои изменнения для всех пользователей?
В общем и целом я с вами согласен в том, что gentoo.ru нужно увеличивать количество предоставляемой информации о Gentoo. Того, что есть крайне мало мало. Но я против ещё одного оверлея, так как ebuild'ы требуют некоторый минимальный уровень QA, который наживался годами разработки и который нужно выдерживать. Исправить подобные ошибки просто, не просто их сразу видеть и поэтому нужны люди, которые много пишут ebuild'ы и способны просматривать ваши ebuild'ы... Между прочим, разработчики сейчас тоже просмотривают ebuild'ы друг-друга. Именно поэтому письма с gentoo-commits имеют в качестве reply-to адреса адрес разработчика сделавшего коммит и список рассылки gentoo-dev. Всё не ясное цитируется в письме и зачастую обсуждается... Только так можно научиться, понять и сделать Gentoo лучше.
Раз уж против русского
Раз уж против русского оверлея пожалуйста переведи http://overlays.gentoo.org/proj/sunrise/wiki/CodingStandards http://overlays.gentoo.org/proj/sunrise/wiki/CodingStandards http://overlays.gentoo.org/proj/sunrise/wiki/HowToCommit и выложи на http://ru.gentoo-wiki.com/wiki/
это уже переведено, осталась
это уже переведено, осталась полировка и выкладывание на sunrise
Классно. Может быть тогда
Классно. Может быть тогда стоит написать вводную статью на русской вики? Которая будет вести на русский перевод на sunrise.
Поддерживаю ваше мнение.
Поддерживаю ваше мнение. Линку в студию...
Скорее я поправлю заглавную
Скорее я поправлю заглавную страницу Sunrise со ссылкой на русский вариант страниц + думаю я добавлю меню на этом сайте со ссылкой на текст, подобный вышеприведённому. А статью на wiki каждый может написать ;)
А за задержки с русской документацией сорри. Просто не успеваю.