Size: a a a

technicalwriters

2020 November 10

E

Evgenya in technicalwriters
Нет, слово не могла подобрать) ну все же когда ты приходишь в новый коллектив и общаешься с коллегами лицом к лицу, то проще и быстрее налаживаешь контакт с ними.
источник

OR

Olga Rodina in technicalwriters
Общаемся в чатиках, смешные картинки пересылаем, рабочие вопросы обсуждаем. Работают тоже хорошо
источник

E

Evgenya in technicalwriters
Это обнадеживает!
источник

OR

Olga Rodina in technicalwriters
Впрочем, они в другом филиале, в другом городе, мы с ними бы и так только онлайн
источник

ET

Elena Tikhomirova in technicalwriters
Sirius
Привет. А кто-то работает удаленно? Я так понимаю официального устройства в итоге нет, но какой-то контракт заключается
И какого это никогда не видеть с кем общаешься. Или это утопия просто)
с марта на удаленке все сотрудники прошлой компании и нынешней. меняла работу на карантине. только заехала в офис привезти документы и забрать аппаратуру.
техпис в продуктовой команде (где разработчики и тестеры) работает наиболее изолированно от других и карантин эту «инородность» не смягчает. я новичок и почти все раб. встречи - без меня.  возможно, если бы сидели в одном офисе/углу опенспейса, то легче было бы находиться в курсе дел, искать актуальные задачи (нахожу себе сама; конкретных задач сверху на меня почти нет).

на вопросы удаленно отвечают норм. кроме того, у нас и так распределенные команды и половина встреч - созвоны с др. странами.

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

OU

Olia Ududiak in technicalwriters
#wanted_tw
Привет 👋! Хочу поделиться вакансией для тех, кто хотел бы создавать контент не только на бумаге, а и распространять его на YouTube канале 🎥 вместе с Railsware.
Требуется: знание английского и умение обучать других, аналитический склад ума. Будет полюсом, если уже есть какой-то опыт с записью видео и умение говорить на камеру на английском. Узнать больше и присоединиться можно на сайте компании: https://bit.ly/36fUzoE
Локация: удаленная работа
источник

Ю

Юлия in technicalwriters
Я и работала удаленно, и меняла работу удаленно.
Пришла в команду, пока проблем нет. Коммуникации налажены))
Стандартное оформление по трудовой.
Да, пришлось один раз в офис ездить, чтоб разом все подписать, но у нас там кадры дежурят почти все время - так что проблем не возникло)))

Да, общение в команде живое...и в кабинете, и в курилке, и за кофе где ничем не заменишь, но ситуация диктует свои условия)))
источник

BF

Bobba Fett in technicalwriters
Поговорим про ревью при docs-as-code подходе?

Как осуществить код ревью исходников - понятно, но когда отдаёшь собранное (ведь оно нагляднее и не все смогут исходники прочитать, особенно если это не маркдаун, а разметка посерьёзнее), то фидбек приходит в не самом удобном виде (комменты в личку или на почту, тикеты в трекере), который в разы уступает тому же комментированию в гугле, например. Есть ли у современных генераторов режим сборки “на ревью”, который сохраняет ассоциации с исходниками, например, даёт возможность ревьеру оставлять комменты на блоках текста и генерит патч с комментами, которые накатываются на исходники и ты уже проходишь по ним. Неплохая фантазия? Что-то подобное есть? Может, кто-то использует какой-то иной подход? Или для подобного ревью ничего не придумано?
источник

АП

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

CV

Cro Vin in technicalwriters
Александр Парень
У нас как-то по проще. Когда началось всё, всех перевели, да заключили какие-то доп.соглашения, чтобы чисто формально было и всё. Потом в июне некоторая часть всё таки вышла, так как надо с оборудованием работать. А мне и разрабам сказали, что как мы хотим так и можем делать, если есть сильное желание, можно приезжать в офис, если понравилось дома, то можно дома. Я так и работаю, только приезжаю, если реально надо глаза в глаза со всякими руководителями направлений переговорить и оунерами, а так всё отладили и работаем.
Если это открытая информация, то какую программу ( Вы или фирма) используете для фиксирования времени, которое затрачено на выполнение работы (проекта)?
источник

АП

Александр Парень... in technicalwriters
Cro Vin
Если это открытая информация, то какую программу ( Вы или фирма) используете для фиксирования времени, которое затрачено на выполнение работы (проекта)?
Ух, не знаю даже, как это проджект-менеджеры считают, но мы с разработчиками LogWork ставим всегда и это потом, где-то высчитывается.
источник

M

Marina in technicalwriters
Lana
Не очень понятно, почему удаленка исключает официальное трудоустройство, благо есть возможность обменяться оригиналами документов через курьера, иначе как бы ИТ компании все лето почти нанимали сотрудников (мы даже ноутбук курьером отправляли, не только контракт) + да как сказали выше ГПХ, договор подряда + самозанятость как опции
опять же, есть квалиф. ЭЦП, ей все доки подписываются
источник
2020 November 11

ET

Eduard Tibet in technicalwriters
Ekaterina Noskova
привет. у нас есть какие-нибудь стандарты индустрии в документировании? например, используется docs-as-code, есть стайлгайд, процессы автоматизированы по максимуму (создание, публикация, тестирование, локализация), Swagger как спека для API документации и т.д.
Сваггер (точнее OAS) не является стандартом в том термине, который вы говорите - т.е. что-то обязательное для применения в индустрии. Есть, например, Blueprint. Так что корректнее здесь говорить о распространенности.
источник

EN

Ekaterina Noskova in technicalwriters
Eduard Tibet
Сваггер (точнее OAS) не является стандартом в том термине, который вы говорите - т.е. что-то обязательное для применения в индустрии. Есть, например, Blueprint. Так что корректнее здесь говорить о распространенности.
да, я скорее best practices имею в виду
источник

EN

Ekaterina Noskova in technicalwriters
недавно поднимали тему метрик в документации. собрала свои мысли в статье https://medium.com/xsolla-tech/analytics-in-documentation-d814bbbe6ea6. будет здорово, если поделитесь опытом и мыслями, на какие метрики вы ориентируетесь, что и как собираете
источник

MC

Milkhail Che in technicalwriters
Bobba Fett
Поговорим про ревью при docs-as-code подходе?

Как осуществить код ревью исходников - понятно, но когда отдаёшь собранное (ведь оно нагляднее и не все смогут исходники прочитать, особенно если это не маркдаун, а разметка посерьёзнее), то фидбек приходит в не самом удобном виде (комменты в личку или на почту, тикеты в трекере), который в разы уступает тому же комментированию в гугле, например. Есть ли у современных генераторов режим сборки “на ревью”, который сохраняет ассоциации с исходниками, например, даёт возможность ревьеру оставлять комменты на блоках текста и генерит патч с комментами, которые накатываются на исходники и ты уже проходишь по ним. Неплохая фантазия? Что-то подобное есть? Может, кто-то использует какой-то иной подход? Или для подобного ревью ничего не придумано?
Dr.Explain собирает вебхелп с возможностью оставлять комменты под топиком.
Возможно, есть сборщик DaC'ов с таким функционалом.
источник

А

Александр Мокрушин... in technicalwriters
Milkhail Che
Dr.Explain собирает вебхелп с возможностью оставлять комменты под топиком.
Возможно, есть сборщик DaC'ов с таким функционалом.
было бы круто оставлять inline-комменты в вебхелпе
источник

MC

Milkhail Che in technicalwriters
Интересную статью вчера прочитал про DaC vs HAT
https://medium.com/@tterrag/when-to-choose-docs-as-code-e72ee31f3613
источник

MC

Milkhail Che in technicalwriters
Разделяю мнение автора, что возня с DaCом отнимает фокус и время от самого контента.
источник

NV

Nick Volynkin in technicalwriters
Всё верно. Возня с девопсом отнимает время от разработки. Возня с тестированием и дизайном — тем более. Ведь только написание кода приносит пользу и ценность.
источник