Size: a a a

2019 November 11

A

Angela in technicalwriters
Sara
Перевод все равно будет ручной почти полностью, плейсхолдеры, вот эти сложные вещи не нужны, по сути, ибо просто текст
ну вот на последнем проконтенте, вроде как, рассказывали оч интересно про перевод с нейронными сетями и подключением AI, выглядело многообещающе)
источник

ET

Eduard Tibet in technicalwriters
Angela
сочувствую, если честно, сфинкс-док это скорее не для локализации, а для создания "по-быстрому" веб-порталов со справкой, а также для кастомизации, если вдруг понадобилась, но на мой взгляд, это не самое оптимальное решение для кучи языков
А свой велосипед в виде: rst > adoc > docbook (xml ) > xliff > CAT > и в обратной последовательности. Да, несколько длинная цепочка, но все же.
источник
2019 November 12

СФ

Семён Факторович in technicalwriters
я тут впервые добрался до официальной документации на Docker (да-да, я слоупок), и она ведь очень крутая!
источник

СФ

Семён Факторович in technicalwriters
источник

СФ

Семён Факторович in technicalwriters
источник

СФ

Семён Факторович in technicalwriters
Ссылка «request docs changes» ведет на страницу создания нового GitHub issue в репозитории с доками
источник

A

Angela in technicalwriters
Семён Факторович
я тут впервые добрался до официальной документации на Docker (да-да, я слоупок), и она ведь очень крутая!
я как то ставила докер композ на убунту, репа из офиц доков с их сайта была устаревшей или неправильной, пришлось брать со стороннего ресурса
источник

A

Angela in technicalwriters
Eduard Tibet
А свой велосипед в виде: rst > adoc > docbook (xml ) > xliff > CAT > и в обратной последовательности. Да, несколько длинная цепочка, но все же.
🙈
источник

L

Lana in technicalwriters
Семён Факторович
я тут впервые добрался до официальной документации на Docker (да-да, я слоупок), и она ведь очень крутая!
Там когда ставишь докер ещё интерактивная обучашка интересная, пуллишь контейнер запускаешь и у тебя в консоли анимация, я раньше не ставила через оф сайт, а тут мне переустановили ос и решила попробовать по-человечески)
источник

АМ

Алексей Москвин in technicalwriters
Поделюсь своими мыслями: третий год работаю техническим писателем и чувствую полное опустошение от профессии.

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

Техническую документацию, как устроена архитектура системы, напишет быстрее и правильнее архитектор, который ПО и разрабатывал.

Чтобы писать документацию разработчика, нужно понимать стэк, который зависит от компании и может быть узким.

Чем заняться техническому писателю? Собрать информацию, переписать «красиво», отправить на ревью.

Не исключаю, что техпис разбирается в стэке, но зачем имея знания разработчика, не перейти туда, где гораздо шире возможности для карьерного роста и больше платят? Если только энтузиазм/нравится писать.

Еще и на рынке бОльшая часть вакансий – ГОСТы и сертификация, и, если это сертификация ФСТЭК – нужно детально разбираться в их требованиях и знать продукт. Опять техпис выполняет роль, по большей части, оформителя.

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

В самом начале пути я вдохновлялся миру IT, мне нравилось то, чем я занимаюсь. Но спустя время у меня пришло разочарование от профессии «красиво переписывать чужой текст».

Готов к камням.
источник

R

Roht in technicalwriters
Алексей Москвин
Поделюсь своими мыслями: третий год работаю техническим писателем и чувствую полное опустошение от профессии.

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

Техническую документацию, как устроена архитектура системы, напишет быстрее и правильнее архитектор, который ПО и разрабатывал.

Чтобы писать документацию разработчика, нужно понимать стэк, который зависит от компании и может быть узким.

Чем заняться техническому писателю? Собрать информацию, переписать «красиво», отправить на ревью.

Не исключаю, что техпис разбирается в стэке, но зачем имея знания разработчика, не перейти туда, где гораздо шире возможности для карьерного роста и больше платят? Если только энтузиазм/нравится писать.

Еще и на рынке бОльшая часть вакансий – ГОСТы и сертификация, и, если это сертификация ФСТЭК – нужно детально разбираться в их требованиях и знать продукт. Опять техпис выполняет роль, по большей части, оформителя.

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

В самом начале пути я вдохновлялся миру IT, мне нравилось то, чем я занимаюсь. Но спустя время у меня пришло разочарование от профессии «красиво переписывать чужой текст».

Готов к камням.
В нашем селе техпис снимает видеоролики по работе с продуктом и гайды прямо в продукте пишет
источник

R

Roht in technicalwriters
Рекомендую поработать в этом направлении
источник

R

Roht in technicalwriters
А простыни да, никто не читает
источник

R

Roht in technicalwriters
Это не значит, что их не надо писать, это значит, что они должны отвечать на вопросы юзеров — а для этого анализируются тикеты в саппорт и пишется действительно востребованная, притом легко обнаруживаемая, информация
источник

D

Daria in technicalwriters
Roht
Это не значит, что их не надо писать, это значит, что они должны отвечать на вопросы юзеров — а для этого анализируются тикеты в саппорт и пишется действительно востребованная, притом легко обнаруживаемая, информация
this
источник

АХ

Алексей Хорьков in technicalwriters
Алексей Москвин
Поделюсь своими мыслями: третий год работаю техническим писателем и чувствую полное опустошение от профессии.

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

Техническую документацию, как устроена архитектура системы, напишет быстрее и правильнее архитектор, который ПО и разрабатывал.

Чтобы писать документацию разработчика, нужно понимать стэк, который зависит от компании и может быть узким.

Чем заняться техническому писателю? Собрать информацию, переписать «красиво», отправить на ревью.

Не исключаю, что техпис разбирается в стэке, но зачем имея знания разработчика, не перейти туда, где гораздо шире возможности для карьерного роста и больше платят? Если только энтузиазм/нравится писать.

Еще и на рынке бОльшая часть вакансий – ГОСТы и сертификация, и, если это сертификация ФСТЭК – нужно детально разбираться в их требованиях и знать продукт. Опять техпис выполняет роль, по большей части, оформителя.

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

В самом начале пути я вдохновлялся миру IT, мне нравилось то, чем я занимаюсь. Но спустя время у меня пришло разочарование от профессии «красиво переписывать чужой текст».

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

СФ

Семён Факторович in technicalwriters
Алексей Москвин
Поделюсь своими мыслями: третий год работаю техническим писателем и чувствую полное опустошение от профессии.

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

Техническую документацию, как устроена архитектура системы, напишет быстрее и правильнее архитектор, который ПО и разрабатывал.

Чтобы писать документацию разработчика, нужно понимать стэк, который зависит от компании и может быть узким.

Чем заняться техническому писателю? Собрать информацию, переписать «красиво», отправить на ревью.

Не исключаю, что техпис разбирается в стэке, но зачем имея знания разработчика, не перейти туда, где гораздо шире возможности для карьерного роста и больше платят? Если только энтузиазм/нравится писать.

Еще и на рынке бОльшая часть вакансий – ГОСТы и сертификация, и, если это сертификация ФСТЭК – нужно детально разбираться в их требованиях и знать продукт. Опять техпис выполняет роль, по большей части, оформителя.

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

В самом начале пути я вдохновлялся миру IT, мне нравилось то, чем я занимаюсь. Но спустя время у меня пришло разочарование от профессии «красиво переписывать чужой текст».

Готов к камням.
> Если только энтузиазм/нравится писать

Только на этом и стоим
источник

R

Roht in technicalwriters
Я просто кроме писать ничего не умею (
источник

СФ

Семён Факторович in technicalwriters
Со всеми, с кем беседую на эту тему, разговор в итоге сводится к «нравится писать / нравится процесс извлечения и упорядочивания информации»
источник

D

Daria in technicalwriters
я бы осторожно предложила поучиться, но это, понятно дело, непрошенный совет
источник