Добрый вечер, кто сможет подсказать в какой пункт ТПр переносить информацию по модели данных (разнообразные таблицы БД) ?

Том Джонсон. Не?

А можно ссылку на ресурс?

Уверена, что тут были уже эти ссылки и не раз :)
Курс по документированию api: https://idratherbewriting.com/learnapidoc/
Его перевод на русский: https://github.com/ka1bi4/learnapidoc-ru

И, кстати, там ещё очень много интересного. Например, было обсуждение про то, почему, возможно, технические писатели для работодателей кажутся не важной частью компаний: https://idratherbewriting.com/blog/why-technical-writers-treated-as-unimportant/

Совсем недавно читала дискуссию на эту тему в рунете. Основные топики - да нафига техписатели нужны, да мы лучше сами напишем, да они вымирающий вид. Ага ага))

https://podlodka.io/223 с озвучкой двух мнений от разработчиков: пользоваться/не пользоваться документацией для работы с API.

Добрый день, гуру технических писателей! Обращаюсь к вам с таким вопросом - как войти в профессию технический писатель? Бекграунд у меня следующий - в данный момент работаю в технической поддержке пользователей и сотрудников страховой компании (топ 5 России), не испытываю проблем в общении с разработчиками, немного занимаюсь ручным тестированием, до этого работал в IT отделе банка. Был опыт ухода из IT, работал на экономических должностях в банке, последние 3 года в банковском секторе работал на позиции управляющего обособленного подразделения банка, в подчинении было до 20 человек, после ряда сокращений вернулся в it, комфортно чувствую себя в тех поддержке, но так как всегда по роду деятельности писал и разрабатывал инструкции для пользователей - хочу попробовать себя в роли технического писателя. Так же имею опыт программирования микроконтроллеров на С, не испытываю больших трудностей в чтении технической документации на английском, в данный момент подтягиваю английский. занимаясь с репетитором.  С чего посоветуете начать? Как создать портфолио? Что туда вложить?

Для начала попробуйте пооткликаться на вакансии начального уровня. Уверен, с таким опытом и навыками, найдёте себе работу легко (если Москва/Питер, в регионах просто предложений маловато).

Спасибо!

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

Я тоже всё думала, а что же подтянуть и подучить для перехода из техписов в тестеры, оказалось ничего, так взяли😆

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

Резюме только подшаманьте красиво, чтобы писательский опыт хорошо был виден

Если речь идет о коммерческой разработке железяк на C, то для начала можете попробовать устремить свой вектор на компании, которые разрабатывают эти решения и им нужен TWR. Т.е. из двух основных компетенций, нужных там, минимум одна у вас есть, вторая - чуть-чуть. P.S. TWR должен уметь вытягивать информацию, поэтому мой совет - поищите по этому чатику по ключевым словам. За 2020-2021 гг. в этом чатике было очень много тредов по поводу "как войти в профессию". И там были даны очень ценные советы.

Паразитическая капитализация

Что объединяет слова КАСКО и СПА?

То, что все они не являются сокращениями, но за каким-то хуем их пишут заглавными буквами.

Каско - это по-итальянски каска. Типа, все накрывает, защищает. В отличие от ОСАГО, которое является аббревиатурой, каско - это просто слово. Не нужно писать КАСКО, блять.

Спа - это просто город в Бельгии. Курорт. Не может существовать никаких СПА-процедур. Только спа-процедуры, дуры.

Та же хуйня с Юниксом, Фидо, Мегой и т. д.

Не нужно капитализировать слова без необходимости.

И заглавные буквы не надо сдавать куда попало ☹️ Никогда не забуду Дата-Центры

#wanted_tw #вакансия #remote #удаленка #middle #Senior #английский #english

Всем привет, в продуктовую IT компанию ищу технического писателя, владеющего английским

Наш продукт называется TaxDome — это SAAS платформа для компаний, занимающихся налогами, финансами и бухгалтерией. Продукт включает в себя CRM и менеджер задач, позволяет компаниям обмениваться сообщениями и документами с клиентами, помогает выставлять счета и принимать платежи.

Количество активных пользователей нашего продукта около 400000 аккаунтов.

Вилка: 1500 - 2000 $ после вычета налогов
Формат работы: fulltime, 100% remote, гибкий график
Контакты: obelyaeva@taxdome.com или @oksanaTXDM
Чем нужно будет заниматься:

🔸Писать документацию для пользователей на английском языке, максимально простым и понятным языком (используем только внутренние стандарты).
🔸Разбираться в продукте с большим числом возможностей, копаться в фичах. Общаться с разработчиками и продактами, если что-то непонятно по фиче
🔸Смотреть на продукт с точки зрения пользователей, всегда хотеть понять, как фича работает и проверять, как она работает, прежде чем выдать доку.
🔸Понимать, чем текст в документации отличается от копирайтинга. Подстраивать свой стиль письма под существующий стиль, понимать, что всегда лучше сделать copy/paste из уже существующих статей, чем изобретать велосипед для каждой новой статьи.
🔸Следовать гайдам по оформлению иллюстраций.
🔸Нежно любить бюллеты, заголовки и анкорные ссылки.
🔸Быть готовым к критическому анализу устаревших статей и их своевременному обновлению.
🔸Быть готовым нести ответственность за актуальность документации в области, за которую отвечаете. У нас не приветствуется micromanagement, зато приветствуется инициативность и самостоятельность.

Наши пожелания к кандидату:
✔️ Опыт работы техническим писателем от двух лет.
✔️ Продвинутый письменный английский язык.
✔️ Умение писать простым и понятным языком.

О компании:
✔️ 70+ человек: разработчики, тестировщики, дизайнеры и продукт-менеджеры.
✔️распределённая русскоязычная команда, Россия и Украина.
✔️ овнеры, продажники и поддержка в США.

Преимущества работы у нас:
✅Платим заработную плату в долларах, регулярно пересматриваем заработную плату.
✅Мы видим конечный результат нашей работы и регулярно получаем фидбек от пользователей.
✅У нас комфортный рабочий процесс и отсутствие бюрократии.
✅Оплачиваем участие в конференциях и программах дополнительного профессионального образования.
✅Обеспечиваем сотрудников техникой и софтом.
✅Два раза в год путешествуем всей командой, совмещая с работой (конечно, за счет компании).

Что дальше: созваниваемся со мной (HR) примерно на 30 минут - техническое задание примерно на 2 часа - оффер

можно подумать, материться без необходимости нужно (( Или тут прямо острая необходимость для этого есть. Кто бы говорил про "паразитическое" что-то там...

Господин Лебедев матом не ругается, он им разговаривает)