Size: a a a

technicalwriters

2020 July 15

B

Burrito in technicalwriters
Kseniya Chudakova
а какую цель вообще преследует этот документ?
очень много легаси кода, сервисы хотят переписать, а разработчики, которые занимались ими  - давно не работают. хочетя понимать, какие ресурсы задействованы в сервисах
источник

KC

Kseniya Chudakova in technicalwriters
Burrito
очень много легаси кода, сервисы хотят переписать, а разработчики, которые занимались ими  - давно не работают. хочетя понимать, какие ресурсы задействованы в сервисах
В таком случае, название + версия + компонент, где используется, зависимости. Выглядит достаточным)
источник

A

Andrey in technicalwriters
Burrito
очень много легаси кода, сервисы хотят переписать, а разработчики, которые занимались ими  - давно не работают. хочетя понимать, какие ресурсы задействованы в сервисах
Сервисы разбиты по серверам?
источник

B

Burrito in technicalwriters
да, примерно так у меня и получилось
источник

B

Burrito in technicalwriters
источник

B

Burrito in technicalwriters
Andrey
Сервисы разбиты по серверам?
не все
источник

IC

Ivan Cheban in technicalwriters
Ну и желательно нарисовать схему взаимодействия компонентов системы
источник

B

Burrito in technicalwriters
хм. интересно. спасибо
источник

A

Andrey in technicalwriters
Burrito
не все
Вам важно деление по серверам в этом документе?
источник

B

Burrito in technicalwriters
такого запроса не было, уточню. спасибо за мысль
источник

IC

Ivan Cheban in technicalwriters
🗿 А в это время в замке: BLM дотянулся и до Линукса. Следуя «a general trend in the tech community», Линус Торвальдс предписал не использовать слова slave и blacklist в коде ядра Linux и сопутствующей документации. Вместо расистских master и slave предлагаются более политкорректные варианты:

— primary/secondary
— main/replica или subordinate
— initiator/target
— requester/responder
— controller/device
— host/worker или proxy
— leader/follower
— director/performer

Вместо blacklist и whitelist предлагаются:

— denylist/allowlist
— blocklist/passlist

Грустно наблюдать, как из английского языка методично выпиливают ни в чем не повинные слова black и white. А вслед за ними из русского пытаются симметрично выпиливать «черный» и «белый». Интересно, как поступят с черно-белыми изображениями и «Белым Бимом Черное ухо».

#терминология
источник

IC

Ivan Cheban in technicalwriters
В каком смысле?
источник

L

Lana in technicalwriters
Burrito
всем привет. Есть ли хорошие примеры описаний стека технологий, используемых в разработке сервиса? пытаюсь сделать табличку для внутренних проектов, интересно, что вы учитываете в таких документах
можещь глянуть чужие техрадары на https://radar.thoughtworks.com/ там помимо перечня используемых технологий еще есть срез насколько они активно применяются, для вдохновения подойдет
источник

L

Lana in technicalwriters
источник

IS

Igor Shakhbazyan in technicalwriters
Ivan Cheban
🗿 А в это время в замке: BLM дотянулся и до Линукса. Следуя «a general trend in the tech community», Линус Торвальдс предписал не использовать слова slave и blacklist в коде ядра Linux и сопутствующей документации. Вместо расистских master и slave предлагаются более политкорректные варианты:

— primary/secondary
— main/replica или subordinate
— initiator/target
— requester/responder
— controller/device
— host/worker или proxy
— leader/follower
— director/performer

Вместо blacklist и whitelist предлагаются:

— denylist/allowlist
— blocklist/passlist

Грустно наблюдать, как из английского языка методично выпиливают ни в чем не повинные слова black и white. А вслед за ними из русского пытаются симметрично выпиливать «черный» и «белый». Интересно, как поступят с черно-белыми изображениями и «Белым Бимом Черное ухо».

#терминология
> Интересно, как поступят с черно-белыми изображениями и «Белым Бимом Черное ухо».
"Монохромный Бим"
источник

B

Burrito in technicalwriters
Ого! Класс 👍
источник

A

Andrey in technicalwriters
Burrito
такого запроса не было, уточню. спасибо за мысль
Если не важно, маппите матрицей:
Сервисы | Типы софта (уровнем ниже детализация типа софта до конкретного софта с указанием версии)
источник

Я

Ягодка in technicalwriters
добрый день.
Меня зовут Мария. Я ИТ рекрутер.
Хочу предложить рассмотреть вакансию Технический писатель Краснодар/Тюмень (работа в офисе)

Требования:
Практический опыт написания ТЗ и инструкций
Знание ГОСТ 19 и 34 как плюс

Обязанности:
Разработка и актуализация технической документации
Ведение библиотек проекта, контроль актуальности версий
Подготовка регламентов и инструкций
Разработка шаблонов документации
#wanted_tw
источник

СФ

Семён Факторович... in technicalwriters
Ягодка
добрый день.
Меня зовут Мария. Я ИТ рекрутер.
Хочу предложить рассмотреть вакансию Технический писатель Краснодар/Тюмень (работа в офисе)

Требования:
Практический опыт написания ТЗ и инструкций
Знание ГОСТ 19 и 34 как плюс

Обязанности:
Разработка и актуализация технической документации
Ведение библиотек проекта, контроль актуальности версий
Подготовка регламентов и инструкций
Разработка шаблонов документации
#wanted_tw
пожалуйста, добавьте тег #wanted_tw
источник

Я

Ягодка in technicalwriters
Семён Факторович
пожалуйста, добавьте тег #wanted_tw
Ok
источник