Size: a a a

technicalwriters

2021 January 17

F

Fagor in technicalwriters
Pandoc норм, а вот mkdocs не зашел. Мне бы графы по тагам натянуть. но, в одно-три лица не вариант создавать среду и методы.
источник

RD

Roman Dynnik in technicalwriters
Коллеги, подскажите короткий пошаговый алгоритм как действовать при переводе markdown/asciidoc и т п, если исходник английский и хранится в github. Требуется:
1) после перевода иметь возможность сравнения с первоначальной английской версией
2) отслеживать изменения в английской версии, ветвлящейся отдельно
источник

RD

Roman Dynnik in technicalwriters
К примеру, если взять следующий репозиторий... допустим первым шагом форкаем текущую версию, какой алгоритм далее?
https://github.com/graphql/graphql-spec
источник

KV

Konstantin Valeev in technicalwriters
Fagor
Pandoc норм, а вот mkdocs не зашел. Мне бы графы по тагам натянуть. но, в одно-три лица не вариант создавать среду и методы.
https://foliant-docs.github.io/docs/preprocessors/metagraph — вот такой граф? :) @Vanderhoof, нам бы красивую картину-пример в доку завернуть.
источник

F

Fagor in technicalwriters
Konstantin Valeev
https://foliant-docs.github.io/docs/preprocessors/metagraph — вот такой граф? :) @Vanderhoof, нам бы красивую картину-пример в доку завернуть.
нет, рисунок от тега это вершинка айсберга, просто принять, что методы сейчас, только визуально могут что то дать, и только. А так не будем о моем мнении, и моих моделях. иначе уйдем от темы топика.
источник

KV

Konstantin Valeev in technicalwriters
Fagor
Я не про требования к документации только, я и про требования к бизнесу, системам, решениям стекходеров, исполнителей, пользователей. Процесс до реализации. А не после реализации.
Кстати, смотрели на эту штуку — https://sphinxcontrib-needs.readthedocs.io/en/latest/?

Она простенькая, конечно, но хоть что-то.
источник
2021 January 18

RD

Roman Dynnik in technicalwriters
О..., я тут нашел довольно точный по смыслу перевод serverless:
"Без управления серверами"
источник

F

Fagor in technicalwriters
Konstantin Valeev
Кстати, смотрели на эту штуку — https://sphinxcontrib-needs.readthedocs.io/en/latest/?

Она простенькая, конечно, но хоть что-то.
не смотрел, спасибо, посмотрю сегодня, как можно применять ее.
источник

A

Aleksandra in technicalwriters
Добрый день.
Подскажите, пожалуйста,  какая обычно зарплата у технических писателей на время стажировки?
Так же интересует, по каким критериям оценивается уровень технических писателей.
Гугл  конечно, в помощь)
Но мне важно знать более экспертное мнение.
источник

NV

Nick Volynkin in technicalwriters
Aleksandra
Добрый день.
Подскажите, пожалуйста,  какая обычно зарплата у технических писателей на время стажировки?
Так же интересует, по каким критериям оценивается уровень технических писателей.
Гугл  конечно, в помощь)
Но мне важно знать более экспертное мнение.
Зависит от города и компании же.
Оценивается:
— умение писать понятно, логично и грамотно
— умение разбираться в незнакомой предметной области
— знание английского, если на нём пишут
источник

MS

Maria Shabanova in technicalwriters
Nick Volynkin
Зависит от города и компании же.
Оценивается:
— умение писать понятно, логично и грамотно
— умение разбираться в незнакомой предметной области
— знание английского, если на нём пишут
И умение описывать несуществующие системы, но это уже после стажировки, чтобы не спугнуть😂
источник

A

Aleksandra in technicalwriters
Спасибо за ответы.
источник

TM

Try More in technicalwriters
источник

TM

Try More in technicalwriters
пример популяризации профессии через творчество)
источник

СФ

Семён Факторович... in technicalwriters
думаю, что все-таки побольше

@koshatneg, как у вас, например?
источник

NV

Nick Volynkin in technicalwriters
Aleksandra
Добрый день.
Подскажите, пожалуйста,  какая обычно зарплата у технических писателей на время стажировки?
Так же интересует, по каким критериям оценивается уровень технических писателей.
Гугл  конечно, в помощь)
Но мне важно знать более экспертное мнение.
А вы ещё студентка или уже закончили?
источник

S

Sergey in technicalwriters
Aleksandra
Добрый день.
Подскажите, пожалуйста,  какая обычно зарплата у технических писателей на время стажировки?
Так же интересует, по каким критериям оценивается уровень технических писателей.
Гугл  конечно, в помощь)
Но мне важно знать более экспертное мнение.
500 $
источник

A

Aleksandra in technicalwriters
Nick Volynkin
А вы ещё студентка или уже закончили?
Закончила.
источник

NV

Nick Volynkin in technicalwriters
Тогда это уже скорее не стажировка, а ставка младшего (junior) техписателя.
источник

NV

Nick Volynkin in technicalwriters
У нас с тобой разные hh )
источник