Всем привет, меня зовут Динара!

В компании Бимэйстер я являюсь Старшим техническим писателем и хочу рассказать немного о правилах оформления технической документации.

Введение

В ИТ-компаниях не сразу пришли к тому, что нужен технический писатель, а про нормоконтроль вообще не задумываются, пока не придет пачка замечаний от заказчика. 

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

Нормоконтроль – на первый взгляд отголосок из Советского Союза или что-то связанное с Госзаказчиками. Но нормоконтроль (далее по тексту НК) – гигиена документа. 

НК включает в себя не только правила русского языка (синтаксис/орфография), но и требования перекликающиеся с ГОСТ.  

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