How to Justify an Emergency Hotfix in English

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

Ключовий словник

** Обхід стандартного процесу ** — явне підтвердження того, що звичайні кроки (повний набір тестів, декілька переглядачів, поетапне розгортання) буде пропущено або скорочено, зазначено безпосередньо, а не залишено неявним, тому всі, хто бере участь, точно розуміють, чого не вистачає у мережі безпеки. “Щоб було зрозуміло, що ми обходимо: це пропуск звичайної вимоги двох рецензентів і вихід з одним схваленням, тому що очікування другого рецензента означає ще 30 хвилин клієнтів, які не можуть отримати. ”

** Радіус взрыву ** — обсяг того, що може статися, якщо сама латка введе нову проблему, що буде ясно зазначено, щоб прийнятий ризик був конкретним, а не абстрактним. “Радиус взрывов тут обмежений — це торкається тільки шляху перевірки коду знижки, а не потоку основного касового процесу, тому навіть погана латка не може повністю припинити платежі.”

** мінімальний реальний виправлення ** — найменша можлива зміна, яка вирішує невідкладну проблему, явно відрізняється від належного виправлення, щоб було зрозуміло, що латка не має на меті бути остаточним, повним рішенням.

• “Це мінімальний можливий виправлення — ми встановили обмеження на розмір вводу, щоб негайно зупинити аварію. Фактичне кореневе виправлення, яке включає переписування аналізатора, відстежується окремо і не є частиною цього розгортання.”*

** Підтвердження подальшої роботи ** — явне, відстежене підтвердження необхідності належного перевірки, перегляду або виправлення проблеми після того, як надзвичайна ситуація пройшла, що запобігає тому, щоб надзвичайне скорочення тихо стало постійним станом коду. *“Наша наступна мета - повний регресійний тестовий набір, запущений проти цієї зміни до завтра вранці, плюс належний перегляд коду, навіть якщо він вже відправлений - ми не вважаємо “це живий” як “ми зробили це” ”. *“

Звичайні фрази

• «Ми обходимо стандартний процес спеціально для [причини], і ось що це означає, що ми пропускаємо»
• “Радиус вибуху цієї зміни обмежений [специфічним обсягом].”
• «Це мінімальний реальний виправлення, а не остаточне рішення — це зупиняється безпосередня проблема без повного вирішення кореневої причини.»
• “Наша наступна дія - [конкретна дія] до [конкретний час], відстежується в [квиток/система].”
• “Ми приймаємо [спеціфічний ризик], щоб уникнути [спеціфічного, більшого, постійного ризику].”

Приклади висловлювань

Запит на схвалення екстреного розгортання:

• “Мені потрібне схвалення для того, щоб обійти стандартний процес випуску для цього виправлення. Ми втратили приблизно $ 2000 на хвилину від помилки каси, і стандартний конвеєр додасть ще 40 хвилин, перш ніж це досягне виробництва. ”*

Пояснення до прийнятого ризику: “Радиус вибуху входить до служби сповіщень — навіть у найгіршому випадку, коли ця латка має свою ваду, вона не може вплинути на обробку платежу або доступ до облікового запису, тому я рекомендую відправити її зараз.”

Обязательства по надлежащему выполнению: “Це мінімальний можливий виправлення, і я хочу чітко сказати, що це не кінець цієї роботи. Я подав квиток на подальші дії для належного виправлення, і я зобов’язуюся мати повне тестове покриття на цьому шляху коду до кінця тижня. “

Професійні поради

• Явно вкажіть, для чого ви ** обходите стандартний процес ** — назвати конкретну відсутню захисну систему (другий рецензент, повний набір тестів, поетапне розгортання) дозволяє затверджувачам прийняти обґрунтоване рішення замість того, щоб просто штампувати.
• Завжди характеризуйте ** радіус розширення ** зміни, а не лише її терміни — невелика, обмежена виправлення виправляє швидкий шлях набагато легше, ніж термінова, але розширена, і затверджувачі потребують цього розрізнення, щоб правильно зважити запит.
• Позначте зміну як ** мінімальний реальний виправлення **, якщо це справді так — це встановить очікування заздалегідь, що належне виправлення все ще прийде, запобігаючи тому, щоб скорочення було помилково сприймено як остаточне рішення через декілька тижнів.
• Ніколи не пропускайте ** зобов’ язання щодо подальших дій ** — аварійне виправлення без відстеження подальших дій є способом невидимо накопичувати технічний борг, і заява про зобов’ язання вголос, з визначеним терміном, робить його набагато більш ймовірним.
• Формувати рішення явно як ризик-компроміс — «ми приймаємо X, щоб уникнути Y» — замість того, щоб представляти латку як безризикову, оскільки одобряючі довіряють запиту більше, коли ризик визнається, а не прихований.

Практичні вправи

1. Напишіть речення, у якому буде чітко вказано, які заходи безпеки обходяться і чому.
2. Описати радіус дії гіпотетичної латки, обмеженої однією, некритичною службою.
3. Написати повідомлення про виконання обов’ язку, що включає дію і термін виконання.

Національний склад населення: Перепис населення 2002 року: Порядок надання статусу населеного пункту

Виправдання екстреного виправлення не просто про оголошення «це зламалося!» Це про повідомлення * чому * це злам вимагав негайної уваги, демонструючи чітке розуміння впливу - як те, що ви адресуєте, так і те, що ви потенційно вводите на його місце. Для не-рідних англомовних носіїв, це може бути особливо складним завдяки тонким відмінностям у фразуваннях і очікуваннях щодо оцінки ризику. Давайте розглянемо, як ефективно вписати цю ситуацію, враховуючи перспективи зацікавлених сторін, які можуть не мати рідної мови з мовою.

Ключовим питанням є розуміння термінології. Фрази на кшталт «зменшити» або «зменшити» часто використовуються при обговоренні тимчасової природи гарячого виправлення. Сказати, що ви просто «влаштовуєте» щось може звучати відверто; це означає постійне рішення, яке не є метою. Замість цього, розгляньте можливість опису того, як ви * зменшуєте * вплив експлуатаційної вразливості або * зменшуєте * ризик подальших перешкод. Аналогічно, «обхідне рішення» часто краще, ніж «хак», навіть якщо це здається менш формально. «Обхід» пропонує прагматичний вихід, щоб користувачі знову були онлайн, в той час як «хак» може означати поспішну і потенційно нестабільну поправку. Коли ви пояснюєте свій підхід у листі до керівника команди, ви можете сказати: « Ми реалізували обхідне рішення для відновлення основної функціональності, активно зменшуючи потенціал пошкодження даних до того часу, поки не буде доступна повністю перевірена латка »

Іншим важливим фактором є визнання компромісів. Не соромтеся стверджувати, що розгортання цієї латки несуть певні ризики. Фрази на кшталт «прийняти обмежений ризик» або «ввести тимчасову залежність» набагато професійніші, ніж наголос на тому, що ви не робите жодних дій. Хороший опис PR може звучати так: « Ця надзвичайна латка вирішує критичну вразливість безпеки, приймаючи короткостроковий ризик потенційних проблем зі сумісністю з [особливою системою], поки ми розробляємо і ретельно перевіряємо постійне рішення ». Важливо вказати, * що * це тимчасова залежність — наприклад, « залежність від цього рішення до випуску версії 2. 5 ». Ця ясність демонструє відповідальний підхід.

Нарешті, підкресліть план ліквідації наслідків. Просто оголошення про те, що ви розгорнули латку, недостатньо; зацікавлені сторони повинні знати, що відбувається далі. Фрази на кшталт «ми будемо уважно стежити», або «ми заплануємо подальший перегляд» показують проактивне управління і зобов’язання повністю вирішити основну проблему. Додання графіка - навіть оцінений - є життєво важливим. Наприклад, «Ми плануємо випустити версію 2.5 протягом 72 годин, включаючи цей латок і подальші тестування». Це демонструє відповідальність і надає запевнення, що ситуація не ігнорується.