Как многие уже знают, у нас есть домен третьего уровня для документации: http://www.doc.crossplatform.ru. Пока там только Qt документация.
Что сделано:
1. Этот домен теперь основной для документации, а не как раньше было crossplatform.ru/documentation/...
2. Дополнительно выложил английскую версию документации.
3. Сделал возможность переключения с русской версии на английскую и наоборот.
4. Добавил ссылки для скачивания архивов с переведенной документацией.

Что-то еще нужно? Пишите не стесняйтесь.
Ну и разумеется критикуйте!

p.s. в эту тему будем писать все пожелания насчет документации.

Документация по бизону полетела.

Не понял, что ты имеешь ввиду?

Нужно придумать механизм по исправлению ошибок в переводе. По выделению и ctrl-Enter или что-то вроде этого.
Имхо, помочь перевести мало кто будет хотеть, а вот пальцем быстро тыкнуть на ошибку или опечатку - это запросто.

контестно чувствительно - очень удобно

хорошая мысль.

Хорошая мысль, нужно будет подумать как это сделать...

А сейчас пока добавлю туда докуменнтацию по:

• ACE
• Boost
• GTK+
• wxWidgets

И думаю добавлять или нет доки по:

• Python
• Java
• Perl
• Базы данных

Добавляй. Не помешает!

жаль только это все не переведенным будет

П.С. Таблички не красивые получились, надо бы с их оформлением что-то сделать.

Пока да, но может кто-нибудь возьмется также!
Добавить хочу для того, чтобы доки были в одном месте и удобней копаться в них было...

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

а что если в вики попробывать в песочнице накидать из тех блочков, что я сделал? Там эксперементировать проще. А потом посмотреть исходник HTML какой вика генерит и от туда взять фрагмент.

html не проблема, просто нужно до конца предатсвлять, что будет...

По PyQt можно, я всё подумываю что-то написать про пикуте, очень прикольная штука.

Ссылку дай откуда их взять!

В wiki песочнице, можно начать и постепенно закончить...

Еще хотелось бы про ОпенГЛ. Но я не знаю какие доки можно выкладывать, а какие нет. А документации по нему масса.

В принципе, вот.
Только со скачать, наверное, проблема.. Но если получится, то там всё на доках по Qt основано, с переводом будет несложно)

Ну нужно отбирать как я понимаю, например SDK под SGI Free Software B License, которая вроде как не запрещает выкладывание доков у себя.
А вот полная документация собранная OpenGL.

Усе, выложил. Ищите глазами: PyQt на главной странице доков...
Теперь дело за переводом.


Еще вот наткнулся на SIP - A Tool for Generating Python Bindings for C and C++ Libraries
Как считаете нужно выкладывать?

Выложи.

вот на этой странице надо скачать PyQt-win-gpl-4.4.4.zip (8 МиБ) в нем есть каталог doc там вся документация (32 МиБ)

Я уже ее выложил...

а-а-а я не посмотрел.
Я вот вижу есть документация на русском по GTK+ (http://www.crossplatform.ru/documentation/gtk2.10/index.php) может ее тоже перенести в поддомен документации?

Угу, сделаю, немного поже, просто для нее нужно будет еще делать перенаправление для поисковиков...

Добавил документацию: ACE, Boost, GTK+.
Добавил навигационное меню чтобы видеть в какой части документации находишься и перейти уровнем ниже...

Выложил Qt документацию версии 4.5.0 бета в снапшетах, как русскую там и английскую версии...

ViGOur, а может не писать версию снапшота, а то неровно стало. Да и потом будет другой снапшот, а в самой документации написаноа версия внизу.

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

я как раз предлагаю писать так: Snapshot и все, без указания версии

еще навигацию надо поправить:

есть проблема с переключением языка в снапшоте, вываливает Error404

Поправил.

Добавил:

• Perl документацию
• wxWidgets документацию

на очереди базы данных и gtk+ русские доки...

Добавил PyGTK к документации Python.

Напал на коллекцию RFC на русском: http://www.protocols.ru/
тока нужна авторизация. (может будет полезно.)

trdm, там слабенькая подборка RFC да и думали мы уже о том, чтобы сделать у себя колекцию, но пока ничего не надумали.

Народ, нужно думать как бы устроить расположение документации на главной, идеи есть?

Я знаю. По этому и написал.
ПС. Курочка по зернышку клюет.

Не в обиду, но пока мы еще не решили, как поступить с RFC. Я пока подумываю может в WIKI засунуть, но пока вика не особо идет, к сожалению.

Обновил документацию на сайте.

П.С. что-то я стал терятся куда такую новость помещать, толи сюда, толи в Объявление для Qt4 RTT

Думаю можно и в новости на сайте...
Сайт то читают.

А мне казалось I18N переведено, или ...

перевод пришел перед самым объединением ПП и я не успел ни проверить ни добавить в свою ПП.

к следующему обновлению будет.
У меня еще лежат переводы Анны.

Добавил в список переводчиков - Kagami.

Залил английскую версию, должна появится минут через 10, изменений на 11,3 МиБ.

На почту мне пришли ее точные координаты настрою на сайте "автоподхват"...

я обновил файлы снимка (http://svn.assembla.com/svn/qt4rtt/qt-snapshot/.....)
а не создавал еще одну версию, чтобы места несъедать лишний раз, поидее само должно на сайте обновится

ViGOur, что-то не обновляется дока на сайте

Усе обновляется. Может у тебя кэш сохраняется непостижимым способом?
Просто для doc.crosspltform.ru я запретил кэширование...

вроде все вычищал, сейчас еще проверю.

Полез через ФФ, где-то находу обновлятся стали странички. Такое ощущение, что период обновления очень большой.
А вот английская так и не обновилась.

А они и не обновляется!

тогда надо ручками, а то там бетта везде светится

ok

В связи с реструктуризацией доков, хочу посоветоваться с вами как лучше сделать.

Сейчас на сайте лежат доки:

• Qt 4.3.2
• Qt 4.3.5
• Qt 4.4.3
• Qt 4.5.0

4.3.2 и 4.3.5 относятся к одной линейке и в документации видимые изменения если и есть, то незначительные.

Если сделать именование вроде:

• Qt 4.3.x
• Qt 4.4.x
• Qt 4.5.x
• Qt 4.6.x
• ...
• Qt 4.N.x

а при обновлении доков из какой-либо линейки обновлять их до последней версии.

Что скажите?
Или можете предлагать свои варианты.

лучше просто
Qt 4.3
Qt 4.4
Qt 4.5
Qt 4.x

По аналогии как в самой документации, там только мажорная да минорная цифры.

Только в низу страницы для конкретности указана полная версия.