Перейти до вмісту

Ask a question and get an answer grounded in these docs, with the pages it came from.

The documentation doesn't cover this yet.Tell us what you were looking for and it can.

Answers are generated from the documentation and can be wrong — check the sources.Esc closes.

Результати перевірки модуля

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

Відкриття вкладки «Перевірка»

Section titled “Відкриття вкладки «Перевірка»”

Відкрийте Бібліотеку модулів і натисніть на назву модуля, щоб відкрити його власну сторінку, а тоді натисніть вкладку Перевірка. Якщо будь-яка перевірка має відкриті результати, вкладка показує позначку з лічильником — N до виправлення — побудовану з тих самих результатів, що перелічені нижче на вкладці, тож ці два числа ніколи не розходяться.

Модуль, який ніколи не проходив вдосконалення чи імпорт, тут ще нічого не показує: вкладка читає Для цього модуля ще не зафіксовано жодної перевірки.

Вибір потрібної перевірки

Section titled “Вибір потрібної перевірки”

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

  • v_N_ · перевірка вдосконалення — перевірка, що виконалась перед тим, як версію N було реалізовано.
  • v_N_ · аналіз імпорту — перевірка, що виконалась, коли версію N було імпортовано як ZIP.
  • поточне вдосконалення · перевірка — перевірка вдосконалення готова, але ви ще не пройшли повз його екран обговорення (див. вдосконалення модуля). Це та сама перевірка, яку показував той екран; щойно ви завершите вдосконалення, цю мітку заміняє версія, яку воно створило.

Для перевірки вдосконалення картка Покриття вимог перелічує кожну вимогу, з якою перевірка звірила результат, по одному рядку на вимогу, з її статусом — MET, PARTIAL, MISSING або ?, коли перевірка не змогла визначити, — і, там де перевірка змогла на це вказати, стовпцем Де, що називає файл (а іноді й рядок), який задовольняє вимогу. Мітка в заголовку картки підсумовує рядки: Усі N виконано зеленим, коли виконано кожен рядок, або M з N виконано жовтогарячим в іншому випадку.

Імпорту нема з чим звіряти вимоги, тож його перевірка ніколи не має таблиці покриття — а часом і висновок перевірки вдосконалення не розкладається в таку таблицю. У будь-якому разі картка читає Ця перевірка не сформувала таблицю вимог замість порожньої таблиці.

Результати: відкриті, вирішені та нотатки

Section titled “Результати: відкриті, вирішені та нотатки”

Під покриттям (або самостійно, для імпорту) результати перевірки поділені щонайбільше на три групи:

  • До виправлення — результати, що досі відкриті: ще не витіснені пізнішою версією. Кожен показує позначку рівня серйозності — ERROR, WARN або NOTE, — файл, якого це стосується, якщо такий є, і текст результату.
  • Вирішено у v_N_ — результати, що були відкритими, коли ця перевірка виконувалась, але відтоді вийшла пізніша версія. Ця мітка позначає, що перевірку витіснено версією v_N_, а не що кожен результат окремо перевірили повторно й підтвердили виправлення.
  • Нотатки — інформаційні результати рівня NOTE, а також будь-які довільні нотатки, які перевірка зафіксувала і які взагалі не прив’язані до конкретного результату (наприклад, відмічені стилі кодування при імпорті або позначення перевіркою вдосконалення виклику sudo() як навмисного й малоризикового).

Виправлення відкритого результату

Section titled “Виправлення відкритого результату”

Біля кожного результату в До виправлення кнопка Виправити через Вдосконалення запускає нове вдосконалення із текстом результату — і файлом, якщо він є, — уже заповненим як опис, тож вам не доводиться передруковувати те, що перевірка вже повідомила. Ви все одно можете відредагувати цей опис перед початком вдосконалення або проігнорувати кнопку й описати виправлення власними словами; це скорочення шляху, а не єдиний шлях.

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

Як результати впливають на статус модуля

Section titled “Як результати впливають на статус модуля”

На позначку статусу модуля впливають лише відкриті результати рівня ERROR у поточній опублікованій версії модуля: саме вони перемикають її на Потребує уваги, разом із відповідним рядком у спливному вікні перевірки (N відкритих результатів перевірки). Попередження й нотатки на це ніколи не впливають, навіть перебуваючи в тому самому списку До виправлення в очікуванні на розгляд.

Через це позначка N до виправлення на вкладці «Перевірка» може відрізнятися від позначки статусу: позначка на вкладці рахує кожен відкритий результат з усіх зафіксованих перевірок — включно з тим, що досі перебуває на екрані обговорення активного вдосконалення, до того як це вдосконалення хоч щось опублікувало, — тоді як позначка статусу завжди відображає лише ту версію, яку ви справді отримаєте сьогодні.