Левый термин — это термин, который присутствуют в терминологическом списке, но отсутствует в тексте. Если с терминологическим списком всё понятно, то вот для определения термина в тексте можно придумать варианты. Самый простой, видимо, роль. Ну и что-то изобрести с терминами в неименительном падеже и вообще отсутствующими в тексте. Что угодно, т.к. таких обычно не много. Далее xpath + несколько строчек кода. Но! мы говорим именно о тестировании того, что документ получился правильным. Как верно отметили коллеги, а можно ли помочь тому, кто пишет документ?

Вообще тесты документации похожи на e2e тесты. Когда они валятся... это ещё пойми, где править

Левый термин - это тот, что отсутствует в списке но присутствует в тексте.

Договорились писать везде Колобок, но люди пишут что попало: Хлебобулочное Изделие, ХИ, объект К, Шар Из Мякиша.
Надо привести к единому виду.

Да, эти тоже левые)) чем плох предложенный в статье подход? Я там как раз заставляю себя не использовать слово "нужно" и его формы

assert_nil File.read('statqya.spell').match('[Нн]ужн'), "Нужн... -> Необходим..."

Отсутствием на старте всего списка альтернативных левых терминов) если их все знать - решений несколько придумать можно.

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

О, привет! Я правильно понимаю, что вы заморачиваетесь по документации?
Собственно, я думаю сейчас над процессом. Собираю сейчас идеальный темплейт с автогенерацией сайта с документацией. Как думаете, для фулстека на джээсе с реактом норм выбрать jsdoc + react-styleguidist + swagger?

Отличная иллюстрация когнитивного искажения, называемого «проклятием знания».

https://m.xkcd.com/2501/

Чем больше знаешь,  тем больше не уверен в своих знаниях.

И это тоже. Но проклятие знания — это про другое. Когда много знаешь в какой-то области, то забываешь, как мало о ней знают другие

Вот и остается только разбрасываться знаниями… вдруг еще где-то прорастет…

Добавим сюда лестницу винтгенштейна и даннинга Крюгера для полноты картины

Да, и тогда уж напомним что Данинг-Крюгера ещё до того как типа задебанкнули все неправильно интерпретировали потому что не читали исходную статью

Ребята! Кто знает в Jekyll как решить проблему с путями на локали? Он всегда ставит по умолчанию пути c / в начале. Линукс интерпретирует это как путь с корня файловой системы.  baseurl: "" или "./" не помогает =( Кто знает что делать?

А ссылки в исходниках со слеша начинаются? Т.е. [page](/link/to/page). Тогда он будет отталкиваться от урлы или базовой урлы. Ну это если через джекилл серв.
А если сбилдил, а потом полез руцями хтмл открывать, то там беда будет всегда -- тут можно попробовать костыль -- https://ricostacruz.com/til/relative-paths-in-jekyll

Спасибо! Подумаю. Хочется что-б в репе дока тоже лежала и её можно было бы открыть на компе.

Ещё в дополнение этой мысли, мне кажется это важно. Может сложиться такая ситуация, что выловленный термин уже разошелся по документации и, если включить его в запретный список, придётся менять всё. Но тут есть отличный паттерн храповика. Каждый коммит не должен увеличивать количество ошибок. Т.е. ввели правило, оно увеличило количество ошибок до 1000. Поменяли настройку храповика и работаем дальше

Всем добрый день.
Возможно здесь такой вопрос обсуждался, но все же.
Скажите пожалуйста, кто то сталкивался с системами  электронного ознакомления с приказам/документами через ЭЦП?
Спасибо.

P.S. Можно в личку

у нас в боссреференте сделано. При трудоустройстве сотрудник подписывает соглашение о том, что учетная запись (логин, пароль) в СЭД является простой подписью, достаточной для внутреннего документооборота. После этого отпадает необходимость внедрять криптографические ЭЦП для СЭД