Вывод: std либы почти всех языков - говно
дока нужна когда у тебя высокоуровневая хрень и тебе надо понять как она работает. А не фигню всякую.
Дока который рассказывает философию стоящую за футурами и реакторами - хорошая дока.
Дока, которая говорит какие генерик аргументы у футур - плохая. Потому что вчера одни, завтра - другие