3 ms·
At work in the past few weeks, I've been expected to document some parts of a large system I've been designing, so that other people can use it. I've now produc
by jerf 17y ago
At work in the past few weeks, I've been expected to document some parts of a large system I've been designing, so that other people can use it. I've now produced tens upon tens of pages of documentation, which still only scratch the surface and have massive gaping holes, some by design, some by sheer necessity. Meanwhile, this stuff is just basic state I need in my head to do what I'm doing, it's not even a full explanation of what's going on; even the code is only covering the what and for a third party to extract the "why" could take a long time.
When it's all in my head, it doesn't seem too large, until I try to get it out on paper and I find that it's a simply huge amount of state.
I'm not feeling too guilty about not having Shakespeare memorized. I've got a lot of things going on in my head that very few people of past eras had to contend with. Sure, if I didn't have a job and didn't care about world news and didn't sometimes do my own writing and have programming projects on the side, I'd be left with tons more time to memorize poetry. But... so what?