Другое дело найти компанию, которая возьмется из человека с таким опытом делать профессионала, бо рынок QA уже давно и надолго перенасыщен

У нас замучились уже искать нормальных QA ( так что спорно про перенасыщение

Одну девочку нанимали, а потом сами же смеялись, что она не знает, что такое localhost. В итоге и девочка ушла (отчасти потому что некомфортно так работать, хотя она была очень обстоятельная, что хорошо), и мы опять остались с одним зашивающимся тестировщиком (зато крутым)

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

Так и TE (QA в Штатах нередко менеджер, а не инженер) тоже может быть работой по тестплану.

Скорее второе. Но даже так, думаю, трудно говорить о настоящем перенасыщении.

В данном случае лучше делать т.н. скетчи (векторные). Для плат - в самый раз. Можете изучить вопрос реализации тут: https://arvutimuuseum.ee/th99/ (не напрямую ваша реализация - там нет хотспотов, но наведет на мысли).

Дополню, если оечь идет о линейном описании чего-либо, то лучше поступить наоборот. Сначала описание интерфейса, а затем сценариев + ссылок назад (если забыли, как работать с интерфейсом). Ссылок именно назад! Грубо говоря, если человек неугомонный, то сделает несколько сценариев, запомнит интерфейс, а потом уже к нему не возвращается (только если забыл). Но такие варианты не подходят для чисто кастомных продуктов (железяк). Для этого в Европе/Штатах ввели т.н. Quick Guide (т.е. for impatients). Чисто маркетинговая фишка, чтобы не вызывать начальный хейт по поводу чтения большого куска документации :)

Спасибо большое!

Конвеерум #12
Разработка пользовательской документации
https://vk.com/video-167014074_456239035

Будем благодарны за репост ссылки на трансляцию!

@ulesko задает правильные философские вопросы

После доклада @Lananovikova про sphinx-confluence я задаю себе этот же вопрос про Confluence. Пускай будет форматом для отображения, в нём управление доступом есть и поиск, а редактировать в нём я больше не хочу. : )

Я техписатель, я хочу коммитать плейнтекст в Git, а визивиг не хочу

«Маркдаун — внучек латеха» (с) Дмитрий Перепелин

Было у отца три сына (reST, asciidoc, MD)...

HTML-вставки в Markdown теперь навевают нехорошие ассоциации

Раз уж зашла тема переезда с MS Word

Конвертировать DOCX в reST, Markdown или AsciiDoc вместе с изображениями:

 pandoc -f docx --extract-media images -t rst -o document.rst document.docx 
pandoc -f docx --extract-media images -t markdown -o document.md document.docx
pandoc -f docx --extract-media images -t asciidoc -o document.adoc document.docx

Изображения будут в директории images. В любой разметке сразу будут правильные ссылки на них.