Size: a a a

DocOps-сообщество

2019 May 31

FM

Fox Mulder in DocOps-сообщество
Antonio
Высшее руководство - нейтивы, разработка в основном русскоговорящие
Я знаю одну историю. ибо знакомая эта, живет и работает в США. По роду деятельности, она что-то типа ТП. Она уже давно гражданка США, но до сих пор, отдает на вычитку тексты нейтиву. Её слова - я до сих пор допускаю ошибки и не имею права отдавать в редакцию тексты с ошибками.
При этом, она давно уже нейтив, по всем экзаменам.
источник

I

Igor in DocOps-сообщество
Экстраполяция по одной точке, ммм
источник

M

Max in DocOps-сообщество
Antonio
Высшее руководство - нейтивы, разработка в основном русскоговорящие
Ну, тогда внутреннюю документацию проще и дешевле вести на русском. И понятнее)
источник

A

Antonio in DocOps-сообщество
Max
Ну, тогда внутреннюю документацию проще и дешевле вести на русском. И понятнее)
У нас вся внутренняя документация на английском
источник

НН

Нац Нац in DocOps-сообщество
Antonio
У нас вся внутренняя документация на английском
Единственный верный путь
источник

M

Max in DocOps-сообщество
Хмм... Русскоязычные люди пишут документацию на (плохом) английском для того, чтобы другие русскоязычные люди потом её читали?
источник

НН

Нац Нац in DocOps-сообщество
Да
источник

A

Antonio in DocOps-сообщество
Кто сказал, что на плохом?
источник

НН

Нац Нац in DocOps-сообщество
Не заметил про плохой и теперь тоже оскорбился
источник

M

Max in DocOps-сообщество
Потому что на хорошем английском даже американцы не пишут...
источник

НН

Нац Нац in DocOps-сообщество
Слабый аргумент
источник

НН

Нац Нац in DocOps-сообщество
Есть нормы, есть controlled language
источник

A

Antonio in DocOps-сообщество
Американцы не знают разницы между it's и its
источник

M

Max in DocOps-сообщество
Мне кажется, это единственный верный путь к тому, чтобы разработчики неохотно писали документацию и редко её читали (
источник

A

Antonio in DocOps-сообщество
Как-то не очень на них ориентироваться
источник

AR

Anna Ryutina in DocOps-сообщество
Nick Volynkin
А какой продукт у вас? И что такое пошаговая инструкция, она как-то обособлена от остальной документации?
Inlinemanual помогает в интерфейсе продукта добавить попапы с небольшой инструкцией. Она не связана с хелпом, кроме ссылки на него
источник

НН

Нац Нац in DocOps-сообщество
Antonio
Как-то не очень на них ориентироваться
Есть мысль что это внутренний рынок и продуктовые компании расслабляют и не для всех норма инглиш онли атмосфера
источник

H

Hartmann in DocOps-сообщество
Max
Мне кажется, это единственный верный путь к тому, чтобы разработчики неохотно писали документацию и редко её читали (
Дело говоришь.
источник
2019 June 01

V

Vanger in DocOps-сообщество
господа а подскажите за алтернативу inlinemanual желательно что бы было либо на desktop иди self-hosted
источник

BG

Bogdan (SirEdvin) Gladyshev in DocOps-сообщество
Хм ... и еще такой странный вопрос. У меня планируется довольно большое количество self-hosted sphinx документации в html формате. Кроме самостоятельной магии с nginx и readthedocs есть еще какие-то self-hosted альтернативы, куда можно деплоить html сайтики?
источник