⚡️Доступность в тестовой документации (1)

Последнее время много думаю про доступность (в смысле accessibility) в рабочей среде. Мне кажется, это гораздо более важная тема, чем доступность, например, e-commerce. Сдается мне, что доступность e-commerce будет меня мало волновать, если в какой-то момент я просто не смогу выполнять работу.

Поговорила на эту тему с коллегами по цеху, со специалистом по Accessibility, с ChatGPT и теперь хочется опубликовать некое саммари.

Почему это важно и нужно?

Доступность - это не что-то, что нужно каким-то “не таким” людям, которые тусуются в своем отдельном закончике. Это что-то, от чего получают бенефиты все.

Если плохая доступность не блокирует кого-то в работе и/или не заставляет работать катастрофически неэффективно - это еще не значит, что этот кто-то от нее не страдает!

Мы все бываем в состоянии стресса (позитивный стресс тоже считается!), физического нездоровья, физической/эмоциональной/ментальной истощенности и в этих состояниях тоже надо как-то работать работу. “Просто взять больничный”, увы, работает в случае только явных болезней и в случае, если мы можем себе его финансово позволить (больничные не всегда оплачиваются и не всегда оплачиваются 100%).

Мы можем работать в компании, где язык документации - английский, что сразу увеличивает mental load.

А еще среди нас есть нейроотличные люди, и очень часто эти люди даже не в курсе того, что они нейроотличные. Они будут страдать от отсутствия доступности и могут даже не понять, почему это им так плохо.

Если я хочу (а я хочу!) чтобы в будущем я в принципе могла работать - это значит, что начинать адвокатировать доступность надо прямо сейчас. Прекрасное будущее не наступит само, нужен какой-то общий консенсус, что доступность - это нужно и полезно. Нужна культура доступности в QA сообществе.

На что можем влиять?

Рабочая среда - это очень много всего. Это помещения, это рабочие инструменты… У нас часто почти нет прямого влияния на все это.

Но есть что-то, на что мы точно можем повлиять прямо сейчас - это наша документация. Поэтому я регулярно занимаюсь бухтением на эту тему и агитирую коллег по цеху насаждать доступную документацию уже сейчас. Тогда есть шансы, что лет через 30 это будет общими практиками:)

Я буду писать про тест-кейсы, но те же принципы применимы к другим видам документации.

Основной фокус

В контексте текста доступность это читаемость разными средствами чтения (глаза тоже считаются), и все идеи крутятся вокруг этого.

Фокус - простота и минимум визуального и информационного шума. Тогда тестировщица тратит минимум усилий на чтение и понимание текста и бережет мыслетопливо на понимание идеи теста, технические детали и само тестирование.

Итак, вот те идеи, которые я собрала на данный момент:

Стуктура текста

- Текст читается сверху вниз, слева направо. По возможности никаких «а теперь вернитесь к п. 2». Звучит как очевидная вещь, но нет. Не так давно я столкнулась с инструкцией из N пунктов, которая начиналась примерно так: сначала выполните п. 2 - 5, потом п. 1, потом 6-10.

- Линейная (не табличная) структура. Да, я знаю, что многие специалистки пишут тесты в табличках. Сами по себе таблички не являются чем-то недоступным по умолчанию. Другое дело таблички в контексте TMS. Это таблички, которые окружены огромным количеством элементов интерфейса (визуальным шумом). “Линейная” структура (текст с заголовками) в TMS более доступна. А еще этот текст можно написать в другом редакторе и потом скопипастить в условную джиру.

- Нет длинных непрерывных блоков текста.

- Нет разделов теста, которые не используются. Если какой-то раздел у примерно всех тестов пуст, но присутствует в тестах - это просто информационный шум. Лучше их удалить.

#подпольный_евангелизм
Очень подходящий тег взяла поносить у Оли Артемьевой:)