А причём тут вообще "пренебрежение"? Трольвадс же сказал: "for fun", а какой фан писать доки?!? Каждый мнит себя кульхацкером и пишет код не для того, чтобы его потом скурпулёзно вылизывать и документировать - добьются компиляции, запустят перделку - всё, фан получен, сорсы - в массы! :) Или я ошибаюсь?А по мне не в доках дело, а в инструментах - чем примитивнее язык (С/С++), тем сложнее докапываться до логики (хотя она КАК БЫ очевидна). Это как с часами - вроде бы все колёсики на виду, но ни черта непонятно! :)) Так что надо двигаться в сторону C#/D, там хоть поменьше кодомусора.
Ну и ещё момент: многие библебатеки написаны чуть ли не на заре линупса, некоторые - свежие, но опять являются чьим-то "портoм", в результате этот тухлокод поддерживается годами, совместимости ради. Перепроектировать этот хлам никому не интересно (а коммерч. компаниям и не выгодно), так что мегабайты обросших библиотек кочуют из дистра в дистр, затрудняя и компиляцию, и переносимость и даже улучшение. Либа более, чем в 500Кб кода - уже не поддающийся осмыслению монстр, так что даже доки тут не панацея - "вся проблема в головах".