Слоеви на проверка
Слоевите на проверка се различни начини на кои проектот проверува дали имплементацијата, документацијата и артефактите за испорака и понатаму одговараат на предвидените правила и очекувањата за квалитет.
Зошто слоевите се важни
Ниту еден метод за валидација не е доволен.
- само документацијата не го наметнува однесувањето
- само тестовите може да ги потврдат погрешните претпоставки
- CI сам не може да ги дефинира правилата што треба да ги спроведува
Слоевитиот пристап е посилен затоа што секој слој фаќа различен вид отстапување.
Вообичаени слоеви на проверка
1. Спецификација и насоки
Првиот слој го дефинира правилото.
Без овој слој, подоцнежните проверки може да бидат строги, но произволни.
2. Рачен преглед
Човечкиот преглед ја проверува намерата, граничните случаи и значењето на производот што можеби сè уште не е автоматизирано.
3. Локална валидација
Скриптите и структурираните проверки ги фаќаат брзите, повторливи проблеми пред промените да стигнат до CI.
4. Тестови
Извршните тестови го потврдуваат очекуваното однесување, но само кога се усогласени со спецификацијата.
5. CI порти
CI ги прави проверките повторливи и видливи низ соработниците и околините.
6. Проверки на распоредување
Работните текови за распоредување потврдуваат дека изградените артефакти и понатаму може да се објават и дека се структурно исправни.
Како треба да се поврзат слоевите
Слоевите треба да се зајакнуваат едни со други по редослед:
- документите и спецификациите ги дефинираат очекувањата
- преглед ги толкува тие очекувања во контекст
- скриптите и тестовите за валидација ги автоматизираат стабилните делови од прегледот
- CI ги извршува тие проверки доследно
- распоредувањето гарантира дека излезот навистина може да се испорача
Добри цели за рана валидација
Примери на силни рани кандидати вклучуваат:
- задолжително присуство на датотека
- комплетноста на локализацијата
- валидност на синтаксата
- скршени внатрешни врски
- забранети уреднички цитати
- успех за генерирање метаподатоци
Овие проверки обично се објективни и не бараат многу трошок.
Let Books контекст
Репозиториумот Let Books веќе документира неколку слоеви, вклучувајќи:
- правила за производ и имплементација во
AGENTS.mdиAGENTS-Implementation.md - валидација на развој и распоредување во
docs/Development.mdиdocs/Deployment.md - правила за уредувачки докази во
docs/blog/README.mdиdocs/sources/README.md - упатства за учење за постепено воведување на CI и валидација
Така проверката станува документиран систем, а не само нешто кон што се стремиме во иднина.