Ошибки в исходной документации Опции Подписка на тему Сообщить другу Версия для печати Скачать тему Подписка на этот форум Режимы отображения Древовидный Переключить на: Стандартный Переключить на: Линейный

[Litkevich Yuriy]

Надо собирать ошибки обнаруженные в исходной документации
----

1. qtxml.html
   
   • Описание:
     в файле qtscript.html навигация выглядит так:
     [Previous: QtSvg Module] [Qt's Modules] [Next: QtXml Module]
     а в qtxml.html так:
     [Previous: QtSvg Module] [Qt's Modules] [Next: QtDesigner Module]
     хотя в место [Previous: QtSvg Module]
     должно быть [Previous: QtScript Module]
     
     
   • Резюме:
     Исправленно в хранилище, но надо проверять в следующих версиях
   
   
   
2. qmainwindow.html - обнаружила Анна
   
   • Описание:
     Есть упоминание несуществующей функции setDockWidgetCorner()
     
     
   • Резюме:
     Оставлено как есть (надо бы у тролей поинтерисоваться).
   
   
   
3. annotated.html
   
   • Описание:
     Незавершенное предложение: QDBusObjectPath - Enables the programmer to identify the
     Должно быть: QDBusObjectPath - Enables the programmer to identify the OBJECT_PATH type provided by the D-BUS typesystem
     
     
   • Описание:
     Незавершенное предложение: QDBusSignature - Enables the programmer to identify the
     Должно быть: QDBusSignature - Enables the programmer to identify the SIGNATURE type provided by the D-BUS typesystem
     
     
   • Описание:
     Незавершенное предложение: QStyleOptionQ3DockWindow - Used to describe the parameters for drawing various parts of a
     Должно быть: QStyleOptionQ3DockWindow - Used to describe the parameters for drawing various parts of a Q3DockWindow
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом иначе сегмент получится один и тот же и перевод будет один.
   
   
   
   
4. containers.html
   
   • Описание:
     Опечатка: "... but here are the guiding priciples:"
     Должно быть: "... but here are the guiding principles:"
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом.
   
   
5. install-x11.html
   
   • Описание:
     Написано: "Run the Qt Examples and Demos either by typing qtdemo on the command line or through the desktop's Start menu."
     Должно быть: "Run the Qt Examples and Demos either by typing qtdemo on the command line or through the desktop's Main menu."
     
     В GNU/Linux дистрибутивах на основе KDE/GNOME это называется главное меню, а не "Пуск"
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом.

Сообщение отредактировал Litkevich Yuriy - 25.10.2008, 10:52

Причина редактирования: добавил еще ошибку

[iReset]

Файл qtestlib-tutorial.html в версиях 4.5 - 4.6.
It is divided into four chapters:
It is divided into five chapters:

Количество глав поменялось, а тут осталось старое. Исправлено только в версии 4.7 (в 4.7.3 уже точно).

Расскажите пожалуйста, а каким образом информация об ошибке вносится в оригинальную документацию (я имею в виду не ту, что на серверах Nokia, а ту, что есть у нас)? Ручным исправлением исходных файлов? А если эта ошибка по какой-то причине вдруг остаётся неисправленной в следующей версии документации?
Вопрос к alex977: а внесены ли замеченные тут ошибки в исходную документацию, выложенную на FTP в qtrtt/tm/etalon? Беглый взгляд показал, что все файлы в каждой из версий с одной и той же датой.
Может, для таких ситуаций завести отдельный проект, который будет предназначен для "перевода" оригинальной документации на её исправленный вариант? Заносим в ПП исправления; при переходе на новую версию документации прогоняем оригинал через эту ПП. Получаем исправленную оригинальную документацию. Конечно, нет гарантии того, что все исправления применятся, но хоть что-то.