Структура описания понравилась. Хотелось бы соблюдения следующего:
1. Набор файлов документации внутри мажорных версий (4.х) не менялся. Т.е. все такие описания сплюсовывать в общий файл "Руководство пользователя". У нас в документах фигурируют конкретные названия документации, не хочется это поддерживать.
2. Объем документации был такой, чтобы Вы могли поддерживать ее актуальность. Для РР (руководства разработчика) это максимум предыдущая минорная версия (при версии 4.0.9 докумнетация не старее чем к 4.0.8.). Для РП (руководства пользователя) достаточно предыдущая промежуточная версия (для 4.1.8 достаточно 4.1).
Лично для нас важнее постоянная актуальность главных документов, чем создание новых докумнетов для покрытия запросов по последним тенденциям.