Документацию подобного класса пишут инженеры-разработчики. Если
раньше это могло быть приемлемо (но не факт, я тогда пешком под
стол ходил, так что тех реалий не знаю), то сейчас это
непозволительная роскошь. На это уйдет минимум треть рабочего
времени специалиста. Поэтому, по возможности, нанимают девочку-приложение, которая по заранее составленному шаблону пишет трехстраничную инструкцию. Но там, где это невозможно, например в манах на очередной процессор, наверняка используют средства автоматизации документирования, ближайший пример - doxygen. Мануалы от чип-вендоров, уверен, на 80-90% генерируются автоматом.