Каналы релиза: stable и preview

В документации SPG99 используются пометки каналов релиза. Они нужны, чтобы пользователь сразу понимал, насколько можно опираться на конкретную возможность в production.

Stable

Stable — основной поддерживаемый контракт.

Для пользователя это означает:

• функциональность предназначена для обычной эксплуатации;
• изменения сопровождаются документацией и changelog;
• breaking‑изменения не происходят «втихую» без заметного переходного периода.

Preview

Preview — функция или сценарий, который уже можно тестировать, но его поведение ещё может меняться быстрее обычного.

Практически это значит:

• используйте preview только там, где готовы к изменениям;
• для production‑критичных сценариев ориентируйтесь в первую очередь на stable‑разделы;
• если функция важна для вашего запуска, заранее согласуйте ожидания с командой платформы.

Как это устроено на практике

Изменения не попадают в боевой контур напрямую: перед выводом в основную поставку они проходят проверку на тестовых и пред‑продовых стендах. Пользователю не нужно знать устройство этих стендов — важно только то, что production‑контур получает уже проверенные изменения, а preview пометки помогают заранее отделить стабильный контракт от раннего доступа.

Как читать документацию

• если страница помечена stable, считайте её основной рабочей инструкцией;
• если страница помечена preview, воспринимайте её как полезный, но более подвижный сценарий;
• если вы не уверены, какой режим нужен именно вам, для production всегда выбирайте stable.