Кожен баг має бути задокументований щонайменше одним вкладенням. За допомогою вкладення(нь) ви надаєте доказ того, що баг виникає на вашому пристрої, операційній системі та/або в браузері.
Примітка: вкладення НЕ замінюють письмову інформацію у вашому звіті. Вони є візуалізацією проблеми та підтвердженням її існування.
Скріншот чи скрінкаст?
Загалом, для функціональних багів потрібен скрінкаст, щоб їх правильно та ефективно показати. Якщо інструкції або керівник команди не вимагають певних вкладень, користуйтеся таким простим правилом, щоб визначити, чи потрібен скріншот чи скрінкаст для вашого бага:
Щоразу, коли для виклику помилки потрібна дія або потрібно показати процес, завантажуйте відеозапис екрану (скрінкаст). Знімки екрана у вигляді статичних зображень є лише моментальними кадрами і не можуть показати справжню причину проблеми. З цієї причини для функціональних помилок завжди потрібен скрінкаст.
Якщо природа помилки статична, наприклад, проблеми зі статичним інтерфейсом користувача (GUI), достатньо зробити знімок екрана, який навіть буде кращим за відео для візуалізації. Знімки екрана зазвичай достатні для проблем, пов’язаних з контентом або візуальними помилками.
Основні вимоги до додатків
Нові додатки мають створюватися для кожного звіту про помилку або відтворення окремо.
Заборонено копіювати додатки з інших звітів про помилки або відтворень.
Додатки повинні містити всю релевантну інформацію про помилку, щоб слугувати доказом.
Вся важлива інформація має бути англійською мовою (або за бажанням німецькою, якщо звіт написаний німецькою), наприклад дата, час, системна інформація та повідомлення про помилки.
При звітуванні потрібно обирати лише один пристрій або браузер і завантажувати додаток саме для нього. Якщо помилку вдається відтворити на інших пристроях чи браузерах, вкажіть це у полі "Фактичний результат".
Не показуйте інформацію, яка може стосуватися інших клієнтів Test IO (наприклад, листи-запрошення або назви вкладок браузера). Показувати встановлені додатки інших клієнтів дозволено.
Не демонструйте особисту інформацію чи непрофесійні дані, такі як фото, відео або підказки автокорекції із помилками. Пам’ятайте, що ваші додатки будуть доступні іншим тестерам, співробітникам Test IO та клієнтам, тож будьте уважні до того, що ви показуєте.
Для тестів вебсайтів поле з URL має бути видно на додатках.
Роздільна здатність має бути достатньо високою, щоб текст і елементи було легко розпізнати.
Завжди записуйте весь екран.
Для звітів про помилки та позитивних відтворень аварій додаток з журналом помилок (збоїв) є обов’язковим. Відео, яке документує аварію, має відповідати доданому журналу — таймінги мають співпадати.
Що потрібно включити в скріншот?
Правила для скріншотів:
Скріншот має бути у форматі JPG або PNG.
Виділіть помилку на скріншоті.
Ми рекомендуємо інструменти для запису та передові практики в такій статті: Скріншоти
Також можна подивитися найпоширеніші помилки в додатках у статті «Поширені помилки у вкладеннях»
Що потрібно включити в скрінкаст?
Відеозаписи екрану (скрінкасти) мають бути якомога коротшими, але достатньо тривалими, щоб показати проблему. Це означає, що варто пропускати кроки, які не викликають помилку. Наприклад, якщо кнопка «Додати в кошик» на сторінці товару в інтернет-магазині працює неправильно, зазвичай не має значення, як саме ви потрапили на цю сторінку. Важливими є останній крок навігації, крок, який викликає помилку, і сама помилка.
Приклад 1: Помилка на веб-сайті, перевірено на настільному пристрої | Приклад 2: Помилка в додатку, перевірено на мобільному пристрої |
Кроки для створення скрінкасту:
| Кроки для створення скрінкасту:
|
Керівники команд можуть надіслати вам запит на додатковий або зовнішній запис. Це робиться для кращого розуміння помилки або у випадках, коли виникають сумніви через неможливість відтворити помилку.
Правила для скрінкастів:
Скрінкасти повинні бути у форматі файлу MP4.
Максимальний розмір вкладення — 25 МБ.
Максимальна тривалість скрінкаста для звітів про баги — 60 секунд, якщо лише ваш баг не потребує демонстрації процесу завантаження або тривалого ручного вводу.
Максимальна тривалість скрінкаста для відтворень і користувацьких історій — 15 секунд, оскільки потрібно показати лише останню дію, що викликала баг.
Записуйте відео одним дублем. Не можна ставити запис на паузу чи вирізати частини посередині. Якщо ваш скрінкаст вийшов надто довгим і потребує редагування, дозволяється обрізати лише початок або кінець файлу.
Прискорення відео заборонене. Якщо запис вийшов довшим за дозволений час, перевірте, чи не показали ви зайві кроки.
Не записуйте жодних звуків (крики дітей, розмови, телевізор, музика, звуки тварин тощо).
Рекомендуємо ознайомитись з інструментами запису і найкращими практиками у статті: Скрінкасти
Поширені помилки з вкладеннями описані у статті: Поширені помилки у вкладеннях
Спеціальні правила скрінкасту для потокових (Streaming) пристроїв:
Завжди записуйте весь екран телевізора.
Скрінкаст має бути у високій роздільній здатності та хорошої якості.
Освітлення в кімнаті не повинно бути надто темним.
Пульт від телевізора має бути видно на скрінкасті. Він має бути повністю та чітко в кадрі.
Для звітів про помилки максимальна тривалість відео — 60 секунд, а для відтворень помилок та User Story — 15 секунд.
Не записуйте фонові шуми (дитячий плач, розмови, телевізор, музику, домашніх тварин тощо).
Скрінкаст має виглядати професійно — не знімайте свої ноги, безлад під телевізором чи подібне.
Як записати скрінкаст для клавіатурних багів
Іноді під час взаємодії з вебсайтами за допомогою клавіш клавіатури комп’ютера виникають баги.
У таких випадках, оскільки ми повинні показати дію, яка спричиняє помилку на скрінкасті, відображення введення з клавіатури є обов’язковим.
Ось чудовий приклад того, як створити скрінкаст з показом натискань клавіш:
Універсальні вимоги до скрінкастів для всіх пристроїв
Розмивання особистої інформації у вкладеннях
Щоб захистити свою приватну інформацію, таку як закладки, назви облікових записів або збережені електронні листи, і запобігти її відображенню на вкладках браузера, ви можете розмити її.
Якщо вам потрібно додати приватну інформацію до вкладень, але ви не хочете, щоб вона була видимою, ви можете скористатися цим прикладом, щоб професійно її приховати. Зверніть увагу, що назви вкладок браузера, де можуть відображатися адреси електронної пошти, імена користувачів або закладки, також мають бути приховані.Важливо, щоб URL залишався видимим, а елементи сайту не були закриті.
З професійних причин важливо уникати приховування інформації на вкладеннях за допомогою намальованих вручну або начеркових методів, як показано в прикладі нижче:
