Я документацию на СН за полной ненадобностью не читал, но подозреваю, что они там все "правильно и солидно" написали. Типа, нам главное, чтоб все видели, что мы ребята серьезные и не лаптем щи хлебам, а то, что это многословно и непонятно, то это нас интересует в последнюю очередь. Документация даже к серьезным вещам часто пишется на простом и понятном ребенку языке и с картинками в большом количестве. Я так понял, это самый нормальный формат. Но походу здесь явно не тот случай