ПосібникиКоротка стаття3 хв

Як працюють версії

Чому чернетка ніколи не застає агента зненацька: чернетки, версії і що означає «чинна версія».

Сторінка Instructions із двома інструкціями у вигляді карток; на кожній видно, коли її востаннє редагували.

Інтерфейс редактора поки що англійський, тому назви кнопок тут наведено так, як вони виглядають на екрані.

Чернетка належить вам

Поки ви пишете, ви редагуєте чернетку. Вона зберігається, поки ви вводите текст, а History (історія) тримає попередні копії, щоб можна було повернутися. Жоден агент не читає чернетку. Можна залишити речення недописаним, і нічого не станеться.

Публікація створює версію

Коли ви вибираєте Publish (опублікувати), чернетка копіюється у версію: v1, потім v2 і так далі. Версія ніколи не змінюється. Якщо агент щось зробив минулого вівторка, можна відкрити версію, якої він тоді дотримувався, і прочитати, що саме йому було сказано.

Чинна версія — та, якої дотримуються агенти

Одна з версій є чинною (у редакторі — live). Саме її отримують агенти, коли дотримуються вашої інструкції. Зазвичай публікація робить нову версію чинною, і підключені агенти самі на неї переходять.

Можна також опублікувати версію, не роблячи її чинною, переглянути її з командою і зробити чинною пізніше. А якщо нова версія виявиться невдалою, можна знову зробити чинною одну з попередніх.

Чому це влаштовано саме так

  • Жодних несподіванок. Агент дотримується лише того, що людина вирішила опублікувати.
  • Зрозумілий слід. Кожна версія зберігається разом із тим, хто і коли її опублікував.
  • Безпечно експериментувати. Спробуйте зміну в чернетці й опублікуйте, коли текст буде як слід.

Спробуйте

Відкрийте інструкцію в редакторі, змініть рядок і подивіться на Changes (зміни): там перелічено, чим чернетка відрізняється від чинної версії. Основні поняття розповідають більше, зокрема про посилання на кшталт @latest і @stable.

Що далі