Как находить несовместимые изменения в заметках о релизе.
Для несовместимого изменения указывайте старое и новое поведение и заявленное действие по миграции. Не считайте каждую заметку о релизе несовместимостью.
Адаптируйте процесс под свою задачу.
Найдите изменения, прямо обозначенные как несовместимые, удалённые или требующие миграции. Запишите затронутую версию, прежнее поведение, замену и предложенный переход. Отделяйте устаревшие функции с будущей датой удаления от изменений, уже нарушающих работающие интеграции.
- Что вы предоставляете
- Видимая документация релиза.
- Что вы получите
- Несовместимые изменения и необходимые действия по миграции.
Посмотрите входные данные и результат.
Иллюстративные входные и выходные данные · учебный пример, а не реальный запуск WebAct
Полей ввода: Пример
Release notes say field full_name is replaced by display_name in version 2.
Готовый пример
Breaking change: consumers using full_name must review the version-2 response and migrate to display_name as documented.
Добавьте эти данные в промпт и скопируйте его в WebAct, чтобы попробовать задачу. Ваш результат может отличаться от примера.
Решения и устранение проблем.
Любая устаревшая функция уже является несовместимым изменением?
Нет. Объявление об устаревании может предшествовать удалению. Сохраняйте сроки и текущую поддержку, указанные в заметках.
Почему действие по миграции неясно в журнале?
Заметка может ссылаться на отдельное руководство или опускать детали внедрения. Сохраните пробел вместо выдумывания поведения замены.
Попробуйте на собственном источнике.
Замените пример своим материалом в промпте. Сохраните нужные требования и скопируйте задачу в WebAct.
Настроить и скопировать задачу ↑