Слојеви провере

Зашто су слојеви важни

Ниједан појединачни начин провере није довољан.

• документација сама по себи не спроводи понашање
• сами тестови могу потврдити погрешне претпоставке
• ЦИ сама не може да дефинише правила која би требало да спроводи

Слојевити приступ је јачи јер сваки слој хвата различиту класу одступања.

Уобичајени слојеви провере

1. Спецификација и упутства

Први слој дефинише правило.

Без овог слоја, касније провере могу бити строге, али произвољне.

2. Ручни преглед

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

3. Локална валидација

Скрипте и структуриране провере откривају брзе, поновљиве проблеме пре него што промене стигну до ЦИ.

4. Тестови

Извршни тестови потврђују очекивано понашање, али само када су усклађени са спецификацијом.

5. ЦИ капије

ЦИ чини провере поновљивим и видљивим међу сарадницима и окружењима.

6. Провере примене

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

Како слојеви треба да се односе

Слојеви би требало да ојачавају један другог по редоследу:

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

Добри циљеви ране валидације

Примери јаких раних кандидата укључују:

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

Ове провере су обично објективне и јефтине.

Let Books контекст

Репозиторијум Let Books већ документује неколико слојева, укључујући:

• правила производа и имплементације у AGENTS.md и AGENTS-Implementation.md
• валидација развоја и примене у docs/Development.md и docs/Deployment.md
• правила уредничког доказа у docs/blog/README.md и docs/sources/README.md
• упутство за учење за постепени ЦИ и увођење валидације

То проверу чини документованим системом, а не само нечим чему се тежи у будућности.