12 Apr
2011
12 Apr
'11
2:26 p.m.
On 4/12/11 1:29 PM, Chuck Guzis wrote:
I'm tired of reading Linux listings where you say
"Where's the
narrative? How does this thing work and why did the author do what
he did? What are his naming conventions?"
I have been looking at a bunch of source projects for various fairly
complicated bits of system code, and you're right, the documentation
sucks, sometimes just a handful of 'man' pages. These were implementing
fairly complicated distributed systems and they don't even bother
properly describing their data structures or communications protocols.
My pet peeve are projects that drag in dozens of libraries, which then
drag in dozens more. Of course, these then conflict with other projects'
expectations, or screw up other already running builds.
I guess the way of the world now is build a vm/sandbox for every fscking
thing you want to try to compile.