Понимаю, что самые полезный инструмент - опыт) Однако, вдруг!)

Если не лень ответить - В чем отличия семантического языка от противоположного?

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

И тут уже можно определяться с курсами и литературой)

Что касается содержания, то для документов по ЕСКД читать общие госты и изучать предметную область.

В несемантической разметке вы обозначаете как-то так: «это слово будет курсивом, а вот это болдом». В семантической так: «это слово — термин, а это слово — название переменной». А потом уже в зависимости от выходного формата текст автоматически оформляется так, как должен. И это оформление одинаковое во всей документации. Когда вы решите оформлять термины иначе, достаточно будет поменять одно правило и не придется перечитывать всю документацию и править оформление.

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

https://proizvodstvo.zyfra.com/2.0/
работал у них, именно в дивизионе машиностроения (продукт Диспетчер).

Благодарю! Это изучаю.

И Вас благодарю!

Семантический язык задает суть объекта, в отличие от несемантического, который задает все, что угодно. @Nick_Volynkin выше по тексту привел абсолютно правильный пример. Приведу со своей стороны: OK в маркдауне не говорит ничего о сути ОК - что это такое. Для маркдауна - это просто слово, выделенное болдом. А <guibutton>слово</guibutton> в docbook (как пример) или btn:[OK] (в adoc) говорит, что это именно название на кнопке, а не что-то другое.

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

Да, понимаю. У меня именно такое образование. Но в связи с большим перерывом в работе именно по профилю, есть трудности с трудоустройством. На последнем месте работы столкнулась с написанием некоторого вида тех.документации...

Хотелось бы, возможно, найти зедась Ментора) Если можно так выразиться.

Который помогал/напрвалял/объяснял/подсказывал
Естественно с оплатой по часам или как договоримся)

И это еще не все. Вы можете настроить автоматизацию таким образом, чтобы, например, она проверяла наличие отсутствие всех кнопок в вашем руководстве. Или, наоборот, собирала все термины, которые вы туда внесли. Понятно, что подобный подход имеет смысл применять только в большим масштабируемых проектах с кучей подсистем и автоматизацией (тестов и не только). Для того, чтобы написать README, семантика не нужна :)

Вы понимаете, что Ментор тоже должен быть из области машинок. Ибо в ИТ - совсем другая специфика.

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

А здесь таковых нет?

Могу судить только по вопросам и дискуссиям, которые здесь велись. По ним - нет. Но м.б. кто-то тихо или скромно сидит и просто ждет своего часа блеснуть :)