Кто на каком языке предпочитает читать документацию?

[miklenew]

Тема выросла от сюда
Вышла книга «Inside Microsoft Dynamics AX 2009»

[lev]

по поводу языков у меня есть свое ИМХО
если уж продвигаешь свою продукцию в какой либо стране (в нашем случае России), то будь добр предоставь всю нужную документацию (в нормальной редакции ) на родном языке этой страны.
Поэтому проголосовал "Русский".
Ну а против самого английского языка ничего не имею, читаю на нем документацию, проблем не испытываю, но лучше на русском

[mazzy]

Добавл пункт "Не знаю/мне все равно" для тех, кто не имеет мнения, но по каким-то причинам не может открыть еще одну ссылку для просмотра результатов.

[mazzy]

Цитата:

Сообщение от lev

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

Мне кажется, что это тоже слишком радикально.
Есть документация нескольких типов.

есть описания ключевых слов/методов/классов, описание установки и т.п. Такую документацию все равно на каком языке читать. ИМХО.
например, http://msdn.microsoft.com/en-us/library/aa631861.aspx

есть описания понятий, паттернов ответы на вопросы Зачем/почему. Вот такую документацию очень хочется читать на русском.
Например, http://msdn.microsoft.com/en-us/library/aa879675.aspx

А есть такая документация, которая обязана быть на русском - описание концепций.
Например, такие вещи нормально воспринимаются только на русском Denis Fedotenko: Себестоимость и закрытие склада
Немного об архитектуре разноски в ГК и проблеме корреспонденции счетов

[Zabr]

Цитата:

Сообщение от mazzy

Мне кажется, что это тоже слишком радикально.

Законодательно в РФ технически сложная продукция обязана сопровождаться инструкциями на русском языке. Другое дело, что требование не всегда соблюдается, но крупные и средние производители это уже делают давно.Как обстоит дело с ПО с законодательной точки зрения - не знаю. Личное мнение: любое ПО, распространяемое в РФ, обязано иметь перевод оригинальной документации на русский язык и не допускаться к продаже без неё.

[belugin]

Цитата:

Сообщение от Zabr

Законодательно в РФ технически сложная продукция обязана сопровождаться инструкциями на русском языке. .

А это относится ко всем продуктам или только к потребительским?

[oip]

Цитата:

Сообщение от lev

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

Например, насколько я понимаю, Боинг и Аирбас не только не рекомендуют, но и строго запрещают переводить мануалы (РЛЭ) к своим самолетам на другие языки.

[lev]

Цитата:

Сообщение от oip

Например, насколько я понимаю, Боинг и Аирбас не только не рекомендуют, но и строго запрещают переводить мануалы (РЛЭ) к своим самолетам на другие языки.

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

[oip]

Цитата:

Сообщение от lev

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

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

Катастрофа Аэрофлот-Дона в Перми в 2008 году произошла, в некоторой степени, и из-за незнания пилотом английского.

Цитата:

Следует отметить, что поскольку оба пилота не выполняли международные полеты
и не имели допуска для полетов по МВЛ, на них не распространяются требования к
владению английским языком. В российском законодательстве подобные требования
предъявляются только к членам летных экипажей ВС гражданской авиации РФ при
подготовке к выполнению международных полетов (Приказ Минтранса РФ от 9 июля
2007 г. № 90).
...
Отдельно необходимо отметить, что анализ уровня подготовки второго пилота по
английскому языку показал, что он был недостаточным для выполнения полетов на
самолете, имеющем техническую документацию только на английском языке.
...

Окончательный отчет МАКа о происшествии.
http://hectop.livejournal.com/777610.html

А в параграфе 1.18.2 подробно описан процесс так называемого "обучения". Очень занимательное чтиво. Рекомендую.

[lev]

to mazzy: соглашусь с Вами...
но мое мнение остается более радикальным

[kashperuk]

Читаю на том, который важен в текущем контексте.
К примеру, при работе с российским функционалом чтение документации по функционалу на англ. имеет мало смысла.
Аналогично и в программировании.

Другой вопрос, что много терминов имеет устоявшееся название на англ. языке.

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

[apanko]

Цитата:

Сообщение от kashperuk

Читаю на том, который важен в текущем контексте.
К примеру, при работе с российским функционалом чтение документации по функционалу на англ. имеет мало смысла.
.

А на каком языке Вы читаете описание датского функционала?

[Kabardian]

Цитата:

Сообщение от kashperuk

Читаю на том, который важен в текущем контексте.
К примеру, при работе с российским функционалом чтение документации по функционалу на англ. имеет мало смысла.
Аналогично и в программировании.

Другой вопрос, что много терминов имеет устоявшееся название на англ. языке.

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

Абсолютно согласен. Я практически так же читаю документацию.

[gatesasbait]

French when possible.

<google transl> Французский, когда это возможно. </google transl>

[kALVINS]

Цитата:

Сообщение от kashperuk

Читаю на том, который важен в текущем контексте.
К примеру, при работе с российским функционалом чтение документации по функционалу на англ. имеет мало смысла.

Полностью с этим согласен.
Меня вообще очень огорчает, что Майкрософт не переводит всю свою документацию на русский язык! Например по модулям "Сервисное обслуживание" и "Учет затрат" до сих пор нет русской документации.
Думаю это одна из причин почему их почти не внедряют.

[gl00mie]

Цитата:

Сообщение от lev

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

Это с какой радости? Ну т.е. если мы отвлечемся от потребительских товаров.

Цитата:

Сообщение от mazzy

есть описания ключевых слов/методов/классов, описание установки и т.п. Такую документацию все равно на каком языке читать. ИМХО.

А если бы эта документация была на немецком или французском - тоже было бы все равно?

Цитата:

Сообщение от belugin

Цитата:

Сообщение от Zabr

Законодательно в РФ технически сложная продукция обязана сопровождаться инструкциями на русском языке.

А это относится ко всем продуктам или только к потребительским?

К слову, да, под законодательством РФ, видимо, понимался в данном контексте Закон РФ "О защите прав потребителей", где совершенно ясно написано:

Цитата:

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

Цитата:

Сообщение от kALVINS

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

Помнится, была такая давнишняя статья How many Microsoft employees does it take to change a lightbulb?, т.е. "Сколько сотрудников Microsoft нужно, чтобы (согласно устоявшемуся в русском языке выражениею) вкрутить лампочку". Там речь шла о том, сколько сотрудников потребуется, чтобы, к примеру, добавить какую-нить пустяковую возможность, к примеру, в набор встроенных функций VBScript или в тот же WSH:

Цитата:

• Один разработчик, чтобы потратить пять минут на реализацию этой пустяковой функции.
• ...
• Один технический писатель, чтобы написать документацию.
• Один редактор, чтобы вычитать документацию.
• Один корректор, чтобы вычитать документацию.
• Один менеджер по документации, чтобы интегрировать написанное дополнение к документации в существующий текст, обновить оглавления, поисковые индексы, etc.
• Двадцать пять переводчиков, чтобы перевести документацию и сообщения об ошибках на все языки, поддерживаемые [в данном случае] Windows. Менеджеры этих переводчиков живут в Ирландии (европейские языки) и Японии (азиатские языки), и оба региаона находятся в часовых поясах, сильно отличных от часового пояса в Редмонде, так что организация общения с ними оказывается весьма нетривиальной задачей.

Причем заметьте: здесь речь шла как раз о том роде документации, которую, по выражению mazzy, все равно на каком языке читать; вон, Microsoft вроде как собирается использовать машинный перевод для локализации части MSDN Library. Когда же речь заходит о чем-то не столь тривиальном, то сложность адекватного перевода возрастает в разы, а с ней - требования к переводчикам и редакторам и время, необходимое на перевод и редактуру.
В результате ресурсов тратится уйма, а локализованная документация в любом случае если и появится, то с запозданием. Вспомните, через какое время выходили на русском переводы книг по тому же программированию? На моей памяти задержки составляли от года до нескольких. Но вернемся к исходному вопросу:

Цитата:

Сообщение от miklenew

Кто на каком языке предпочитает читать документацию?

К кому обращен этот вопрос? К разработчикам, консультантам, менеджерам проектов, конечным пользователям, наконец? По-моему, все категории, за исключением последней, в силу специфики работы, должны иметь возможность читать как минимум документацию по системе, с которой связана их (т.е. наша ) профессиональная деятельность, на английском языке - языке оригинала, в данном случае. Потому что это ради конечных пользователей вендор может позволить себе переводить пользовательскую документацию (а тренинги по функционалу, надо заметить, адресованы в т.ч. конечным пользователям) на язык той или иной страны, а кто будет переводить разного рода анонсы? кто будет локализовывать бета-версии? кто будет переводить всю последнюю документацию по той же разработке, которая конечным пользователям даром не нужна? А если ждать, пока все это будет переведено, то можно, как бы помягче сказать... отстать от поезда. «В этом мире, чтобы оставаться на месте, надо бежать со всех ног, а чтобы продвинуться вперед, надо бежать вдвое быстрее» © Льюис Кэрролл.

[miklenew]

Цитата:

Сообщение от gl00mie

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

Не знаю Денис. Может действительно должен.
Только вот знать бы кому.
С MS меня ничего не связывает, и никогда не связовало.
Лояльно к MS я не отношусь.
Потому что, играют больно грубо.
Лишь бы на всех всё свалить и остаться в стороне.
А в стороне тоже можно, полезное делать. Было бы желание.
Так что им то я точно ничего не должен.
Клиенту может. Но специалисту платят не за то, что он книги читает.
А за то что он работает.
А так скоро окажеться, что MS ничего никому не должен, зато вокруг одни должники.

Цитата:

Сообщение от gl00mie

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

Это поезд отстал.
Люди вышли и пошли своим ходом.
С продуктом можно вообще работать без документации, методом научного тыка.

Цитата:

Сообщение от gl00mie

«В этом мире, чтобы оставаться на месте, надо бежать со всех ног, а чтобы продвинуться вперед, надо бежать вдвое быстрее» © Льюис Кэрролл.

Вот я щас и побегу в прямом смысле этого слова.
И для здоровья полезнее и для мозгов. Мир становиться проще.

Цитата:

- Что это? - спросила она. - Мы так и остались под этим деревом!
Неужели мы не стронулись с места ни на шаг?
- Ну, конечно, нет, - ответила Королева. - А ты чего хотела? © Льюис Кэрролл.

[lev]

Цитата:

Сообщение от gl00mie

Это с какой радости? Ну т.е. если мы отвлечемся от потребительских товаров.

Ну например. Предположим что в России, нет Аксапты Microsoft собрался продвигать Аксапту на территории России. И предлагают программу с подробнейшей документацией (технической и пользовательской) на английском языке. Сколько % Российских работников смогут правильно прочитать и перевести этот текст, именно так, как подразумевает компания Microsoft? И соответственно настроить, доработать и т.п. эту программу?
В итоге получиться, что кто-то что-то неправильно понял, кто то понял по своему. И возникнет куча проблем.
Компаниям, которые захотят эту программу, надо будет искать только тех сотрудников, кто сможет свободно прочитать и понять то, что предоставил Microsoft. И от этого будет зависеть успех внедрения.
А если сама компания позаботиться об этой документации, то думаю таких проблем не возникнет. Да и авторитет компании это повысит (как никак позаботились о том, кому хотят продать программу).
Но это моё ИМХО, может я и не прав

[ZornFire]

Документацию технического типа предпочитаю на английском, а вот докуметацию любую другую только на русском. Эффективнее, мне так кажеться.

[lev]

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