Size: a a a

technicalwriters

2021 February 20

MC

Milkhail Che in technicalwriters
Люблю, когда Первый заголовок читается одной фразой с последующими.

Но не понимаю, какой должна быть пунктуация, где двоеточия ставить?
источник

MC

Milkhail Che in technicalwriters
источник

MC

Milkhail Che in technicalwriters
И вообще, нормально ли использовать такой прием в документации?
Анонимный опрос
32%
Норм
68%
Не норм
Проголосовало: 41
источник

LT

Lidia Tulyaganova in technicalwriters
такой приём норм, если документация короткая, а если между подзагами объёмный текст, то первая часть предложения (основной заг) теряется и вообще теряется и смысл приёма
источник

LT

Lidia Tulyaganova in technicalwriters
но это моё личное мнение, субъективное
источник

LT

Lidia Tulyaganova in technicalwriters
в идеале каждая часть должна быть как какой-то цельный объект, законченное произведение подзаг+текст. Основной заг только объединяет их. Я думаю так
источник

K1

Kali 1000 in technicalwriters
Milkhail Che
Люблю, когда Первый заголовок читается одной фразой с последующими.

Но не понимаю, какой должна быть пунктуация, где двоеточия ставить?
Я бы сделала так.

Оповещения отправляются во время работы:

1) с документами
- при создании;
- удалении;
- перемещении;
- …

2) задачами
- при создании;
- удалении;
- перемещении;
- ...

предлог при перечислении используется один раз в верхней строчке. Нумерация улучшает восприятие основного списка.
источник

SR

Stas Rychkov in technicalwriters
Оформите просто заголовочную фразу полным предложением. Это чтобы не увлекаться вложенными списками, которые у вас напрашиваются. А Штаты пишут вполне даже и так.
источник

SR

Stas Rychkov in technicalwriters
Kali 1000
Я бы сделала так.

Оповещения отправляются во время работы:

1) с документами
- при создании;
- удалении;
- перемещении;
- …

2) задачами
- при создании;
- удалении;
- перемещении;
- ...

предлог при перечислении используется один раз в верхней строчке. Нумерация улучшает восприятие основного списка.
Формально так нельзя. Нет точек или двоеточия в пунктах. Зато читается.

Но вот у Дитмара Эльяшевича по этому поводу, кажется, ничего. Или чего?
источник

K1

Kali 1000 in technicalwriters
Stas Rychkov
Оформите просто заголовочную фразу полным предложением. Это чтобы не увлекаться вложенными списками, которые у вас напрашиваются. А Штаты пишут вполне даже и так.
Не к Розенталю, к Мильчину) Двоеточие в пунктах с номерами можно опустить для читабельности, если там одно слово. Если больше, тогда ставим двоеточие. Точки в конце пунктов, если есть подпункты, не ставятся.
источник

MC

Milkhail Che in technicalwriters
Спасибо за советы
источник
2021 February 21

BF

Bobba Fett in technicalwriters
Помимо того, что я в целом противник продолжать фразу пунктами списка, так ещё и теряется «заголовочная» функция заголовка. Как потребитель инфы, мне важны структурные элементы, которые я могу выхватывать и либо вчитываться, либо пропускать для экономии времени. А вот такая структура вынуждает меня внимательно вчитываться даже в то, что я могу уже знать, потому что заголовки, вводный текст и пункты списка не являются отдельными элементами, мне нужно составлять их в нужную фразу
источник

MC

Milkhail Che in technicalwriters
Bobba Fett
Помимо того, что я в целом противник продолжать фразу пунктами списка, так ещё и теряется «заголовочная» функция заголовка. Как потребитель инфы, мне важны структурные элементы, которые я могу выхватывать и либо вчитываться, либо пропускать для экономии времени. А вот такая структура вынуждает меня внимательно вчитываться даже в то, что я могу уже знать, потому что заголовки, вводный текст и пункты списка не являются отдельными элементами, мне нужно составлять их в нужную фразу
Интересное мнение, спасибо
источник

T

Tamara in technicalwriters
Всем привет! Есть ли здесь бывшие data scientist'ы? Работаю в data science уже несколько лет и задумываюсь о смене профессии. Было бы здорово пообщаться с кем-нибудь, кто прошёл похожий путь :)
источник

am

anastasiia murkina in technicalwriters
Tamara
Всем привет! Есть ли здесь бывшие data scientist'ы? Работаю в data science уже несколько лет и задумываюсь о смене профессии. Было бы здорово пообщаться с кем-нибудь, кто прошёл похожий путь :)
Было бы интересно узнать, почему задумываетесь о смене профессии и думаете уйти из DS   :)
источник

T

Tamara in technicalwriters
Подустала кодить) Я лингвист по образованию и как-то заскучала. А ещё в DS методы работы специфические - исследования, эксперименты, многие из которых оказываются неудачными. Можно большую работу проделать и не получить результата. Кому-то нравятся эти околонаучные подходы, но меня они скорее расстраивают) Задумываюсь о специальности, где больше контроля и осязаемый результат работы
источник

V

Vyacheslav in technicalwriters
Tamara
Подустала кодить) Я лингвист по образованию и как-то заскучала. А ещё в DS методы работы специфические - исследования, эксперименты, многие из которых оказываются неудачными. Можно большую работу проделать и не получить результата. Кому-то нравятся эти околонаучные подходы, но меня они скорее расстраивают) Задумываюсь о специальности, где больше контроля и осязаемый результат работы
Может, вам в Veeam техрайтером попробовать? Как раз нужно писать на английском и иметь хороший технический бэкграунд.
P. S. Я там не работал, только видел вакансию и описание компании)
источник

T

Tamara in technicalwriters
Видела эту вакансию, но пока в раздумьях
источник

FM

Fox Mulder in technicalwriters
Tamara
Всем привет! Есть ли здесь бывшие data scientist'ы? Работаю в data science уже несколько лет и задумываюсь о смене профессии. Было бы здорово пообщаться с кем-нибудь, кто прошёл похожий путь :)
data scientist - от 300к
tech writer - 40к
источник

T

Tamara in technicalwriters
В дата саенсе не всё так радужно, а у писателей - не так грустно, насколько я знаю)
источник