Инструкция к сервису 3D-сканов за сутки: 10 страниц и 16 размеченных скриншотов

Разработчик облачного сервиса просмотра 3D-сканов зданий и территорий в браузере (геодезия, BIM). Сервис в бете, функций много: навигация, замеры, площади, срезы, аннотации, BIM, а пользовательской инструкции к модулю осмотра сцены не было. Первым этапом заказчик попросил описать три функции: полёт по сцене (клавиши, мышь, переход кликом в любое место), линейные замеры и переход по локациям. Формат Word, скриншоты в режиме максимальной детализации и только на чистых участках скана: в сцене есть плохо отсканированные зоны. Аннотации заказчик вынес в отдельный этап, на работу дал два дня.

Начали с того, что сами прошли тестовую сцену бизнес-парка в браузере: 600 МБ и около 10 млн точек, при первом открытии она грузится около 2 минут, и до полной загрузки картинка размыта. Это вынесли в начало инструкции вместе с требованиями к компьютеру: дискретная видеокарта, Chrome или браузер на его основе, мышь с колесом.

Доступ в админку к старту не пришёл, поэтому снимали по публичной ссылке. Кадры брали в режиме «Макс. детали» на участках, где скан чистый. Каждый скриншот разметили номерами, рамками и подписями, чтобы текст ссылался на конкретную кнопку, а не на «значок справа».

Документ собрали по разделам: экран просмотра и режимы качества, перемещение клавишами и мышью, переход кликом в любое место, кнопки вида и меню скорости, линейный замер по шагам от точки A до точки B, панель замеров, переключение локаций. Там, где пользователь легко ошибётся, дали совет: клик по стене подводит камеру к ней вплотную, и тогда выручает сброс вида.

Отдельно проверили чистым окном браузера, что замеры в публичном просмотре видит только тот, кто их поставил, чтобы не обещать в инструкции лишнего.

Вместе с первой версией спросили про точность: в разных местах сцены она отличалась от ±15 мм до ±500 мм. Заказчик объяснил, что она зависит от плотности облака точек в начале и конце замера. В тот же день дописали это в раздел замеров с практическим советом: ставить обе точки на плотно отсканированные участки, а при крупной погрешности переставить замер.

Инструкция в Word на 10 страниц с 16 рисунками: экран просмотра, перемещение по сцене, линейные замеры с панелью результатов и локации. Первая версия сдана через несколько часов после старта при сроке два дня, в тот же день по уточнению заказчика вышла вторая, с разделом о точности замеров. Заказчик принял работу в тот же день. Аннотации он сам вынес в следующий этап, а мы предложили дописать раздел для администратора, как только появится доступ в админку.