Локализација CI и CD

Посакувани проверки

• доследност на инвентарот на локали
• свежо генерирање на страницата пред преглед на паритетот
• валидација на врски
• генерирање на статии и страници
• проверка на правописот каде што е достапна
• паритет на местодржачи
• основни тестови за пристапност
• проверки за покриеност на снимки од екран и дијаграми

Правило за свежо генерирање

Тековите на локализацискиот CI и прегледите не смеат да ги засноваат наодите за паритет на застарени генерирани артефакти.

Потребен редослед:

1. генерирајте ја страницата од тековната состојба на репозиториумот
2. извршете ги валидаторите врз свежо генерираниот излез
3. по потреба прегледајте го генерираниот HTML
4. по потреба прегледајте го рендерираниот излез

Ова е важно затоа што изворниот Markdown, генерираниот HTML, објавениот излез и однесувањето рендерирано во прелистувач може привремено да се разликуваат за време на развојот.

Приоритет на преглед

Најстрогиот преглед на мајчин јазик и прегледот на паритет прво применете ги на:

• новосоздадена содржина
• неодамна проширена содржина
• содржина што моментално се уредува

Потоа постепено проширете ги истите стандарди за преглед и на постарата локализирана содржина.

Прогресија на класи на дефекти

Локализацискиот CI треба да ги следи и двете:

• Localization Debt
• Open Defect Classes

Долгот ја мери преостанатата работа на изворната содржина.

Отворените класи на дефекти мерат дали системот и понатаму дозволува некоја категорија проблем повторно да се појави.

Штом една класа на дефекти ќе достигне нула појавувања, нејзиниот валидатор, каде што е практично, треба да премине од советодавен во блокирачки режим.

Примери:

• објавување нацрт со местодржач
• непреведени резимеа
• непреведени метаподатоци
• непреведени тела на текст
• објавување на мешани јазици

CI не е само чувар на влезот. Тој е механизмот што спречува затворените класи на дефекти тивко повторно да се отворат.

Редослед на генерирање за навигација на статии

Тековниот договор за јавна навигација на статии е:

• post-article-nav
• related-content
• related-topic-nav

Генерирањето и валидацијата треба да се одвиваат по овој редослед:

1. генерирајте HTML за статии
2. генерирајте индексни страници
3. извршете ја секоја преостаната накнадна обработка на навигацијата само ако сè уште е потребна
4. валидирајте го свежо генерираниот излез
5. прегледајте го генерираниот HTML или рендерираниот излез ако текот на работа бара човечка проценка на паритетот

Ако валидаторот сè уште го очекува наследениот блок topic-nav, ажурирајте го валидаторот на тековниот договор наместо да го крпите генерираниот HTML.