Size: a a a

technicalwriters

2021 February 01

L

Lex in technicalwriters
Alyona Devon
спасибо, забыла про него)
правда смотрю у него нет ответа как в одном предложении 3 слова (одинаковых или синонимы) красиво поместить. и примеров не могу найти. может потому что так не делают, делают только через знаки >
или начинают новое предложение.
через знаки > или | сильно проще. Ни синонимов, ни лишнего текста. Отличная практика
источник

L

Lex in technicalwriters
> 1. Вопрос не к Вам.

это неконструктивная манера беседы.
источник

AS

Al Sku in technicalwriters
Диалог с конкретным человеком в личке, а тут уж будьте добры
источник

H

Hartmann in technicalwriters
Как обычно: начали за здравие, закончили за упокой.
источник

ME

Maria Ermakovich in technicalwriters
источник

BF

Bobba Fett in technicalwriters
Alyona Devon
ну три раза подряд написать go go go
или click click click в одном предложении тоже не ок как-то)

на русском звучало норм. на англ что-то сложно перевести оказалось именно эту часть)
Насколько я помню, в MS MoS так и есть: Click the File menu, then click Paste As, then click Plain Text.

Всегда можно сократить: On the menu bar, click File > Paste As > Plain Text. Думаю, такой вариант вполне понятен 99% пользователей.

А иногда эти конструкции на самом деле лучше писать отдельными шагами.

Ну и я присоединюсь к тем, кто против использования синонимов. Это имеет смысл для SEO, то есть если в топике про шорткаты использовать shortcut, hotkey, key combination и прочее, то юзеры куда более вероятно попадут именно в топик прошорткаты, когда будут искать эту тему. Синонимы же для художественной красоты могут наоборот обернуться вопросами и проблемами. Особенно учитывая тонкую разницу в семантике. Например, те же choose и select - разные слова. Их МОЖНО использовать на месте друг друга, но семантически choose - это скорее делать выбор у себя в голове, то есть в целом (you can choose between foo and bar), а select - это больше про конкретное действие в интерфейсе.

Похожее с разницей между click, navigate, go to, select и прочими: что конкретно вы хотите от юзера.
источник

AD

Alyona Devon in technicalwriters
всем спасибо за полезные ссылки и аргументы 🙏🏻🙌🏻, думаю они будут полезны всем собратьям кто тоже "забыл" или не знал
источник

СФ

Семён Факторович... in technicalwriters
Nick Volynkin
Согласен, синонимы опасны. Про них у @factorized есть прохладная история, там было что-то про файловую систему.
Михаил Острогорский любит эту байку рассказывать

там что-то про большой документ про устройство файловой системы на HDD (там, где секторы, кластеры, сегменты и цилиндры)

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

смысл документа, ожидаемо, сильно исказился
источник

СФ

Семён Факторович... in technicalwriters
Полагаю, выражу общее мнение, отметив, что такой тон не способствует конструктивной дискуссии и может оскорбить участников беседы. Пожалуйста, доносите ваше доводы мягче.
источник

EN

Ekaterina Noskova in technicalwriters
Семён Факторович
Полагаю, выражу общее мнение, отметив, что такой тон не способствует конструктивной дискуссии и может оскорбить участников беседы. Пожалуйста, доносите ваше доводы мягче.
удивительно, что еще не забанили, если смотреть по сообщениям за два года, токсичности очень много
источник

EN

Ekaterina Noskova in technicalwriters
нет, посмотрела из любопытства по истории чата
источник

AD

Alyona Devon in technicalwriters
а есть название правила, а еще лучше ссылка на официальный источник по теме, когда знаки препинания (точка, запятая) вносятся внутрь кавычек? https://monosnap.com/file/wrbY2X29ETKUGchqqEAdVpk5jcGxCL

никак не привыкну, если будет этому логика может будет легче)
источник

АС

Анастасия Степанова... in technicalwriters
Тут вроде бы искали писателя на удаленку

https://t.me/technicalwriters/63886
Telegram
Irina Brykalova in technicalwriters
#wanted_tw  

Компания:  iDG

Формат работы: удаленка
Занятость: полная
Зарплатная вилка: 40К - 60K рублей, 25K - part time

👋Всем привет.
Мы занимаемся разработкой собственных образовательных проектов, а также проектов для клиентов - технологических, финансовых и аудиторских компаний.
Позиция: технический писатель.

Обязанности:
✔️Создание эксплуатационной технической и проектной документации, которая будет использоваться другими группами разработчиков в рамках компании;
✔️Работа с большим объемом информации, ее анализ и структурирование;
✔️Взаимодействие с группами разработчиков;
✔️Создание документации на двух языках: русском и ❗️английском



Требования:
🔘Высшее техническое образование в области ИТ или высшей математики. ❗️Также рассматривать студентов старших курсов на неполный или полный курс обучения;
🔘 6 + месяцев в аналогичной должности или любой должности в ИТ;
🔘 Знание методов разработки и подготовки технической документации с использованием текстовых и графических редакторов;
🔘 Общее понимание…
источник

ЮГ

Юлиана Грехова 🦋... in technicalwriters
Анастасия Степанова
Тут вроде бы искали писателя на удаленку

https://t.me/technicalwriters/63886
Telegram
Irina Brykalova in technicalwriters
#wanted_tw  

Компания:  iDG

Формат работы: удаленка
Занятость: полная
Зарплатная вилка: 40К - 60K рублей, 25K - part time

👋Всем привет.
Мы занимаемся разработкой собственных образовательных проектов, а также проектов для клиентов - технологических, финансовых и аудиторских компаний.
Позиция: технический писатель.

Обязанности:
✔️Создание эксплуатационной технической и проектной документации, которая будет использоваться другими группами разработчиков в рамках компании;
✔️Работа с большим объемом информации, ее анализ и структурирование;
✔️Взаимодействие с группами разработчиков;
✔️Создание документации на двух языках: русском и ❗️английском



Требования:
🔘Высшее техническое образование в области ИТ или высшей математики. ❗️Также рассматривать студентов старших курсов на неполный или полный курс обучения;
🔘 6 + месяцев в аналогичной должности или любой должности в ИТ;
🔘 Знание методов разработки и подготовки технической документации с использованием текстовых и графических редакторов;
🔘 Общее понимание…
Благодарю за помощь) Но не совсем формат подходит)
источник

M

Maeg in technicalwriters
Alyona Devon
а есть название правила, а еще лучше ссылка на официальный источник по теме, когда знаки препинания (точка, запятая) вносятся внутрь кавычек? https://monosnap.com/file/wrbY2X29ETKUGchqqEAdVpk5jcGxCL

никак не привыкну, если будет этому логика может будет легче)
источник

DL

Danil L in technicalwriters
Alyona Devon
а есть название правила, а еще лучше ссылка на официальный источник по теме, когда знаки препинания (точка, запятая) вносятся внутрь кавычек? https://monosnap.com/file/wrbY2X29ETKUGchqqEAdVpk5jcGxCL

никак не привыкну, если будет этому логика может будет легче)
источник

AD

Alyona Devon in technicalwriters
спасибо 😊😊
источник

H

Hartmann in technicalwriters
Alyona Devon
а есть название правила, а еще лучше ссылка на официальный источник по теме, когда знаки препинания (точка, запятая) вносятся внутрь кавычек? https://monosnap.com/file/wrbY2X29ETKUGchqqEAdVpk5jcGxCL

никак не привыкну, если будет этому логика может будет легче)
Вот как Grammarly реагирует на подобное, например:
https://prnt.sc/xyzldj
источник

H

Hartmann in technicalwriters
источник

H

Hartmann in technicalwriters
Ну и собственно:
“Note: Literal-minded tech people are often resistant to the American style, on the grounds that it's illogical. However, despite its illogic, the American style shows no sign of going away, even in technical publications; if you look at 100 books published by major American publishers (even technical books), chances are good that at least 99 of them use the American style. For example, in early 2017, recent O'Reilly and Apress books that we looked at still use the American style.”
источник