Size: a a a

Технические писатели

2021 August 23

L

Lex in Технические писатели
Если будете писать доку на английском, то критически важен. Если на русском, то, соответственно, менее важен. Однако на английском много прекрасных статей и книжек, так что без английского почти никак, как и во многих других сферах деятельности.
источник

정제니 in Технические писатели
Я вот за корейским сижу... Тоже интересно...
источник

SM

Sergey Monk in Технические писатели
Я например, статьи на английском прекрасно читаю с помощью гугл переводчика.))) Меня больше интересует, насколько английский актуален в данной специальности. Я только изучаю это направление, и хотел бы понимать насколько рынок насыщен техническими писателями. Буду рад, если поделитесь своими мыслями...
источник

IK

Ivan Kondrashov in Технические писатели
а можете 2-3 книги в пример привести?
источник

FM

Fox Mulder in Технические писатели
Очень актуален! Многие вкусные вакансии закрыты от тех, кто не владеет очень хорошим английским, например от JB
источник

SM

Sergey Monk in Технические писатели
Спасибо. Но, например для стартового капитала, технического русского достаточно?)))))
источник

FM

Fox Mulder in Технические писатели
Конечно нет )
источник

SM

Sergey Monk in Технические писатели
начинается.....
источник

FM

Fox Mulder in Технические писатели
Ну а как вы собрались писать на английском языке техническую литературу в компании JetBrains или Intel, не имея этого самого языка?
источник

SM

Sergey Monk in Технические писатели
не собирался я даже) Только на русском. Хотя бы понять что и как пишеться. В какой последовательности
источник

FM

Fox Mulder in Технические писатели
А мм, ну лан. Я тогда неправильно понял.
источник

L

Lex in Технические писатели
В основном, конечно, книжки на английском ради английского, например Elements Of Style за авторством William Strunk. Или Keys to Great Writing, Последнюю, если перевести на русский. то получится почти Ильяхов (утрирую) 🙃

Техписателю не всегда тексты надо писать. Мы пишем доку для разработчиков и у нас техписы помогают разработчикам придумывать правильные названия апишкам.
По апишкам, конечно, лучше смотреть доку к той платформе, на которой эти самые апишки работают.  Это помогает соблюсти конвенции и прочие стайлгайды. Но стайлгайды обычно выдают готовый набор рекомендаций. А без английского артефакты апишки грамотно не обозвать.

Чтобы почитать рассуждения о том, как сообразить хороший программный интерфейс, мне понравилась книжка The Little Manual of API Design, Jasmin Blanchette, Trolltech, a Nokia company. Там разбирается общий подход к наименованию  и составлению апишек к UI фреймворку на примере QT.

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

IK

Ivan Kondrashov in Технические писатели
спасибо большое. приму все к сведению
источник

SM

Sergey Monk in Технические писатели
Я хотел сказать, что для начального понимания процесса, его нужно изучить на родном языке. А потом, повышать уровень. Но это мое видение вопроса.Могу ошибаться
источник
2021 August 24

L

Lex in Технические писатели
списочек из того, что нашел в наших внутренних рекомендациях

The Curious Case of the Misplaced Modifier by Bonnie Trenga
Every Page is Page One by Mark Baker
Keys to Great Writing by Stephen Wilbers and Faith Sullivan
Microsoft Manual of Style, 4th edition by Microsoft Corporation
Handbook of Technical Writing by Gerald J. Alred, Charles T. Brusaw, and Walter E. Oliu
Managing Writers: A Real World Guide to Managing Technical Documentation by Richard L. Hamilton
Technical Writing 101: A Real-World Guide to Planning and Writing Technical Content by Alan S. Pringle and Sarah S. O'Keefe
Technical Writing Principles, Strategies & Readings by Diana C. Reep
источник

IK

Ivan Kondrashov in Технические писатели
ох. еще большее спасибо. прям вот, огромное огромное спасибо
источник

BF

Bobba Fett in Технические писатели
В чём вы измеряете важность? В отличие от многих других технических специальностей, у писателя естественный язык - это основная среда. Важен ли английский будет зависеть от компании. У нас довольно сильное разделение миров тех, кто работает на российский и международный рынок. Распространено мнение, что в международных компаниях интереснее задачи, выше зарплаты и приятнее условия, но всегда есть исключения. Разобраться в профессии можно и без английского, но с английским значительно больше возможностей.
источник

FM

Fox Mulder in Технические писатели
Срочно! Сохраняем наши инструкции!
https://4pda.to/2021/08/23/389568/instruktsiyu_ot_kompyutera_apple_ii_prodali_za_pochti_800_000/
источник

SM

Sergey Monk in Технические писатели
Спасибо за развернутый ответ.
источник

L

Lex in Технические писатели
чтобы внуки обогатились? :)
источник