Size: a a a

Технические писатели

2021 September 10

FM

Fox Mulder in Технические писатели
Да. Думаю ты прав. Так как видео по тому же Gulp очень много, даже слишком, а вот конфигурирование Gulp под генераторы, под задачи техписов, нет.
То есть  понятно. Любой frontend middle + уровня, знает и умеет в Gulp or Webpack.
====
Еще 1 пункт вспомнил пока писал про фронтов.
Часто, техписам уровня сеньор, приходится писать и в js, и в hbs (мой случай). Так вот, в данном пункте очень не помешали бы знания как раз бы для техписов, а не фронтов.
Поясню. Я работаю с Antora и данный генератор использует hbs в качестве коллекций слоёв.
Далее, я эти слои использую напрямую в adoc-файлах. И вот как раз информации о том, как писать hbs для технической документации с последующей версткой, как раз и нет.
Или, более популярный пример, Hugo io. Данный генератор разработан на Go, и хорошо бы, если эксперт объяснил механизм разработки themes. В hugo очень много неявных зависимостей внутри кода. И если я хочу написать свою тему, то вместо колупания всего Go and js, хорошо бы знать, куда сразу копать.
В своё время, когда я разрабатывал свою тему, некоторые зависимости так и остались для меня непонятны.
источник

FM

Fox Mulder in Технические писатели
И сразу еще пункт.
Индексация и поисковики.
Скоро мне предстоит прикрутить поисковый движок (пусть будет Algolia). Вот хорошо бы чтобы эта тема тоже была в курсе.
источник

VM

Victoria Matveeva in Технические писатели
#wanted_tw#вакансия#Netсracker
Компания: Netcracker Technology. Мы разрабатываем OSS/BSS решение для телеком индустрии по всему миру. Нашими клиентами являются крупнейшие телеком операторы как AT&T (USA), TELUS(Canada), Telstra (Australia), T-Mobile (Germany), NTT (Japan).
Вакансия: https://spb.hh.ru/vacancy/47022520?from=employer
Формат работы: гибкий график, полная занятость
Опыт: 3-6 лет
Контакт: @Viktoriya_Matveeva Viktoriia.Matveeva@netcracker.com
источник

ЕТ

Елена Толмачева... in Технические писатели
Коллеги, активно работающие с DITA-сборками docx под гост 19, откликнитесь в личку, пожалуйста.
источник

OR

Olga Revyakina in Технические писатели
плюсуюсь под этим пунктом
источник

AK

Anya Kuchumova (Ovsy... in Технические писатели
о как круто, хочу на такие курсы)

я бы ещё добавила что-то про локализацию: автоматизация, сложные случаи и подводные камни, best practices.

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

O[

Olga [olgademoscu] in Технические писатели
О, круто, я бы сходила!
источник

정제니 in Технические писатели
плюсуюсь, ты + разрабы = как бы это сделать для готового продукта
источник

FM

Fox Mulder in Технические писатели
Есть много команд, например Яндекс, Intel, где инженерией документации занимаются отдельные люди, которые не пишут документацию.
Я против такого подхода. Считаю, что с определённого уровня, технический писатель обязан обладать компетенциями, смежными с другими профессиями.

Но я не настаиваю )
источник

ДЧ

Дарья Чернавина... in Технические писатели
Мб распределение труда помогает при масштабировании и при большом потоке задач? Поэтому в крупных компаниях так?
источник

FM

Fox Mulder in Технические писатели
Может и так. Но чем больше компания, тем сильнее снижается персональная ответственность за результат - всегда можно найти внешние факторы, которые "влияют" и влияют на результат.
Тут судить не берусь.
источник

L

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

L

Lex in Технические писатели
Если в небольшой компании работает один-два техписа, то они сами себе короли и им хорошо бы уметь своими инструментами рулить самостоятельно.
источник

OO

Olga Orlova in Технические писатели
Ищу работу техническим писателем. Портфолио у меня нет. Решила наполнить гитхаб хотя бы тестовыми решениями. Не сохранилось ли у кого тестовых заданий? По поиску нашла несколько на английском.
@litulyagan, не поделитесь заданием, которое вы делали для Семена Факторовича?
источник

NV

Nick Volynkin in Технические писатели
Сделайте себе сайт с резюме и портфолио, это отличный проект и для обучения, и для поиска работы.
источник

OO

Olga Orlova in Технические писатели
Сайт? Неожиданное предложение. На тильде смогу, наверное. Но всë же я хочу вернуться в технические писатели. Потенциальный работодатель захочет почитать текст. Чем бы заполнить-то тот сайт?
источник

NV

Nick Volynkin in Технические писатели
Я имел в виду на гитхабе. Начать можно вот просто с репозитория с одним readme.md про себя.
источник

А

Александр Мокрушин... in Технические писатели
Попробуйте на Hugo сделать сайтик и хостить на github pages. У Hugo много  готовых тем для сайтов-резюме
источник

А

Александр Мокрушин... in Технические писатели
Можно там же разместить инструкцию, как такой сайт сделать. И о себе расскажете, и текст будет
источник

FM

Fox Mulder in Технические писатели
Вот вам идея. Сделайте сайт-блог на hugo.io, выложите его на github.io or netlify.com.
Сделайте там инструкцию о том, как вы разворачивали репу, настраивали hugo и подгоняли  theme под себя.
профит!
источник