Submission package як boundary захисту
Submission package — це не архів усього repository, а компактний набір, з якого reviewer може зрозуміти проблему, запустити bounded core flow, побачити evidence і відрізнити факт від Unknown. Пакет має бути достатнім для відтворення, але не повинен приховувати відсутні перевірки за красивою презентацією.
Repro audit перевіряє шлях від чистого checkout до очікуваного сигналу: передумови, команда старту, безпечні fixtures, expected output, observed output і відомі environment gaps. У навчальному прикладі результат аудиту завжди відокремлюється від самого checklist: опис процедури не доводить, що її виконано.
Що має пройти через audit
| Шар | Питання reviewer-а | Як позначити прогалину |
|---|---|---|
| Entry point | Чи зрозуміло, з якого стану й командою почати? | Needs verification або конкретна missing prerequisite |
| Inputs | Чи є безпечні fixtures без secrets і PII? | Unknown input dependency; не вигадувати дані |
| Observable output | Який сигнал означає, що core flow пройдено? | Acceptance signal не визначений |
| Evidence | Де diff, checks, notes і limitations? | Посилання відсутнє або result Unknown |
| Boundary | Що пакет не доводить? | Явно виключити deployment, adoption і production readiness |
Submission package
# SUBMISSION_PACKAGE.md
Problem: <bounded problem>
Core flow: <one observable scenario>
Start: <safe command or manual entry point>
Inputs: <fixtures without secrets>
Expected signal: <observable output>
Evidence: <diff, checks and notes>
Repro audit: <REPRO_AUDIT.md anchor>
Known limits: <unsupported cases and Unknowns>
Status: documented example; submission and reproducibility result: Unknown.Канонічне джерело уроку · JavaRush
Відкрити матеріал JavaRush