Обновление версий

basalttrail следует семантическому версионированию: ломающие изменения бывают только в мажорных версиях.

С 1.x на 2.0

Версия 2.0 убрала устаревшие функции и изменила поведение по умолчанию. Основное:

Добавлено маскирование полей.
Текстовый кодировщик теперь выравнивает уровни.
Счётчики сэмплирования сбрасываются каждую секунду, а не каждую минуту.

Политика устаревания

Устаревшие функции помечаются в документации и в коде и продолжают работать до следующей мажорной версии.

Обо всех удалениях заранее сообщается в списке изменений.

Порядок обновления

Обновитесь до последней минорной версии текущей мажорной.
Исправьте все предупреждения об устаревших функциях.
Перейдите на новую мажорную версию и прогоните тесты.
Сверьтесь со списком изменений на случай изменений поведения.