Слоеви на валидација
Како повеќе фази на валидација намалуваат различни класи грешки во содржината, генерираниот излез, имплементацијата и тековите на работа при испорака.
Слоевите на валидација се одделни проверки што го испитуваат системот од различни агли. Еден слој може да проверува синтакса, друг структура, трет квалитет на локализација, а четврт прикажан излез. Ниту еден поединечен валидатор не може сигурно да го фати секој значаен проблем.
Слоевитиот пристап е важен затоа што дефектите се појавуваат во различни фази. Изворен документ може да биде добро обликуван, но семантички слаб. Генерирана HTML страница може да биде структурно валидна, а сепак да прикажува непреведен текст на интерфејсот. Демо-приказот може да изгледа правилно на екран, а лошо да се печати. Секој од тие проблеми бара различен вид проверка.
Затоа зрелите документациски и софтверски цевководи ретко се потпираат на еден чекор на linting. Тие комбинираат валидација на формат, проверки на врски, проверки на паритет, проверки на пристапност, проверка на build и преглед специфичен за излезот. Водичот за учење за додавање правила за валидација и CI gate-ови по фази опишува како тимовите можат постепено да го усвојат тоа, наместо да се обидат одеднаш да автоматизираат сè.
Во Let Books слоевите на валидација веќе постојат преку преглед на локализација, проверки на генериран HTML, меѓујазични споредби и проверка на структурата на страницата. Третирањето на печатениот излез како поддржана функционалност ја проширува истата логика. Ако документацијата е наменета да работи како PDF или на хартија, однесувањето при печатење треба да има сопствена фаза на валидација, наместо да се третира како изборна козметичка грижа.
Wiki страницата за слоеви на валидација го покрива референтниот поглед. Оваа тематска страница го нагласува општото начело: секој нов пат на испорака или вид документација треба да ги наследи постојните слоеви што веќе го штитат квалитетот на друго место.