Фраза «прототип работает» ничего не говорит, пока не названы версия, задача, условия и доказательство. Он мог один раз проехать по ровному полу без нагрузки; это наблюдение. Он мог выдержать заданный маршрут десять раз с журналом токов; это уже другой уровень вывода. Хорошая карточка версии не делает проект менее впечатляющим — она делает следующий успех различимым.
Один экземпляр, одна дата, одна граница вывода
Карточка всегда относится к конкретной конфигурации, а не к красивому имени семейства. Начните с четырёх строк:
Версия: Z40-Vxx
Дата среза: ГГГГ-ММ-ДД
Задача этой конфигурации: …
Что она пока НЕ доказывает: …Последняя строка — не ритуальная скромность. Например, «есть видео движения» не доказывает тормозной путь, повторяемость, безопасность рядом с людьми или пригодность чужой сборки. Именно эта граница защищает читателя от подмены демонстрации результатом.
Восемь полей, без которых утверждение не проверяется
| Поле | Вопрос читателя | Что считать хорошим ответом |
|---|---|---|
| Версия | К какой сборке это относится? | Уникальный ID и дата |
| Утверждение | Что именно заявлено? | Одно проверяемое предложение |
| Статус | План, сборка, наблюдение или подтверждённый результат? | Не общий эпитет, а тип состояния |
| Метод | Осмотр, расчёт, демонстрация или испытание? | Названный метод без смешения уровней |
| Условия | При какой нагрузке, среде, конфигурации? | Условия, которые меняют вывод |
| Критерий | Что считали успехом или отказом? | Наблюдаемый порог или событие |
| Артефакт | Где исходное свидетельство? | Фото, схема, лог, протокол или видео |
| Ограничение и следующий тест | Чего результат не доказывает? | Честно названный пробел и следующий шаг |
NASA использует более формальную матрицу верификации: требование связывается с методом, критерием, средой и объективным свидетельством. Эта форма — не копия стандарта NASA, а лёгкая редакционная версия той же дисциплины.
Две строки лучше десяти общих обещаний
Ниже учебный пример структуры. Он не описывает подтверждённые характеристики «Зари 40».
| ID | Утверждение | Метод и условия | Результат | Артефакт и граница |
|---|---|---|---|---|
| T‑01‑MECH‑01 | Крепление датчика остаётся на месте после 20 минут вибрации на стенде | test; указанная масса, частота и крепёж | pass/fail по смещению более 1 мм | фото до/после + журнал; не доказывает ресурс в поле |
| T‑01‑SAFE‑02 | При потере команды привод переходит в заданное состояние | test; указанная версия ПО и скорость | время реакции и фактическая траектория | лог + видео; не доказывает E‑Stop |
Важны не красивые слова, а возможность другому человеку спросить: «какая версия? где условия? что именно измерили?»
Как читать пустое поле
«Не проверено» — полноценный результат, если рядом сказано, что именно отсутствует и каким тестом вопрос будет закрываться. Пустое поле без такого пояснения — не честная неизвестность, а потерянная информация.
Проверьте три ловушки:
- Характеристика без условий. Масса, скорость или ток без метода измерения и конфигурации — слабое утверждение.
- Видео вместо протокола. Видео может быть отличным свидетельством события, но без условий редко доказывает устойчивое свойство.
- Слово «совместимо». Оно ничего не значит без границ механики, энергии, данных, отказа и версии обеих сторон.
Практический шаг
Возьмите одну собственную конструкцию и заполните только одну строку: «что утверждаю», «как узнаю, что это правда», «где останется свидетельство», «чего это не доказывает». Если в строке нельзя назвать критерий, вы нашли не недостаток документации, а неоформленную гипотезу.
Источники
- NASA, Requirements Verification Matrix — связь требования, метода, критерия и свидетельства.
- NASA-HDBK-4008 — прослеживаемость от требования к проектному решению и проверке.
- OSHWA Definition — открытая документация важна для изучения и изменения дизайна, но не равна автоматически доказанной воспроизводимости.
Следующий шаг: посмотреть, как связаны версия, BOM, схема и протокол.