Каждая новая фича в РДО должна быть задокументирована в справке (та, что по F1). Помимо описания синтаксиса необходимо добавить и теорию вопроса. Чтобы из справки получился электронный учебник. Если хотите, электронный конспект лекций.
- Однотипные главы (описание rule'ов, operation, event) должны быть сгруппированы в объемлющей, например, Описание образцов
- Название каждой главы с Загланой буквы, тоже название, но в тексте справки между тегами <H1>ТОЛЬКО ЗАГЛАВНЫМИ</H1>
- В названиях существительные во множественном числе, например Описание образцов
- Документация основана на стилях. Забывать про них или заводить новые не надо, т.е. оформляйте текст на основе существующих. Предложения по изменению стилей принимаются.
- Уделите особое внимание примерам. Чем больше, тем лучше. От простого к сложному. Не забывайте про пример использования вашей фичи
- Добавить быстрый поиск фичи по ключевым словам. Не забываем про синонимы, в том числе на русском
- Упоминание про новые фичи должны появиться в разделе 'Что нового'