# Doc Workgroup

## 1. Над чем решили работать по результатам исследований, проведенных в рабочей группе.

Обновить раздел по отображению и редактированию данных в GridControl. Эта задача объемная, т.к. пришлось переписать весь раздел, добавить базовые концепты, сделать фокус на сценарии. Выбрали эту задачу, потому что на тему редактирования у нас большой объем вопросов (15%) среди всех вопросов по гриду. Также док ишьюсы показали много локальных проблем.

## 2. Какие подходы и методы использовали в процессе исследований (удачные и не удачные).

* ***Как искать места, где что-то не так с докой.***

Doc Issues показывают нам куда в первую очередь смотреть в доке.

* ***Как улучшить доку.***

Doc Issues не помогают найти способы улучшения.

Применяем ручное изучение раздела доки (DocIssues - это только локальные проблемы, приходится смотреть на всю секцию в целом).

При переписывании стараемся избегать сильной фрагментированности информации (У нас было много дублирующей информации, написанной по разному в куче мест. Пользователю тяжело пробираться через такой поток. Выделяем основные концепты и описываем их в подходящих топиках. Неважно, будет ли кастом док или апи).

Минимизируем хождение по ссылкам для пользователя.

Упрощаем структуру и вложенность (У нас была очень сильная вложенность, сделали ее плоской чтобы пользователю не скакать по подсекциям).

Добавляем базовое описание концепта (механизм работы ячеек грида).

Добавляем информацию по решению типовых задач.

В Intellisence можно включить полезные ссылки на доки.

## 3. Какие метрики определили для измерения прогресса.

* ***По тегам категорий***: [число тикетов по категории в месяц] / [всего тикетов в месяц] - Сейчас это примерно 15% в месяц. Если снизим до 10%, то это будет успех. Возможно не будет никаких изменений. Но это не означает, что работа была впустую, возможно придется подробнее изучить качество тикетов (Simple, Advanced).

* ***По тикетам с линками на интересующие доки***: [число тикетов с линками в месяц] / [всего тикетов в месяц] - 1-я метрика более показательна, поэтому от этой метрики решили отказаться.

* ***Doc Score*** - для темы редактирования недостаточно оценок чтобы полагаться на эту метрику.

## 4. Какой результат имеем на данный момент.

Раздел готов к публикации. Последний этап принятия правок от корректоров.