Changelog як evidence для version window
Changelog research починається з явного version window: від якої source version до якої target version досліджуємо зміни. Потрібно читати офіційні release notes, migration guides або changelog sections для кожного relevant переходу, а не покладатися на назву нової версії.
Мета — не переписати весь changelog, а витягнути зміни, які можуть вплинути на affected code, configuration, runtime, build, integrations або operations.
Класифікація знайдених змін
| Тип зміни | Що перевірити в repository | Результат запису |
|---|---|---|
| Breaking API | imports, calls, signatures, adapters | affected symbol і focused check |
| Deprecation/removal | usage, configuration, replacement path | version + official section + action |
| Behavior change | outputs, errors, ordering, retries | representative scenario і contract impact |
| Configuration/runtime | env, defaults, startup, deploy | assumption, environment check, owner |
| Unknown | недоступне або неоднозначне джерело | Unknown + конкретний next check |
Мінімальний запис changelog finding
## Finding: <version and change>
- Source: <official URL or repository file:section>
- Affected area: <module, API, config, runtime>
- Change type: <breaking | deprecated | behavior | operational>
- Expected impact: <what may change>
- Confidence: <confirmed | needs verification | Unknown>
- Next check: <focused command or scenario>Порядок changelog research
- Зафіксуйте source version, target version і межі пошуку.
- Зберіть офіційні release/changelog entries у межах version window.
- Відфільтруйте breaking, deprecated, behavior, configuration і operational changes.
- Зіставте кожну зміну з конкретним repository area або позначте її як неaffected.
- Додайте evidence anchor, confidence і наступну focused verification.
- Зупиніться, якщо target або relevant release evidence залишається Unknown.
Канонічне джерело уроку · JavaRush
Відкрити матеріал JavaRush