3 ms·
> I read a lot of code too, which wasn’t always easy, but sometimes I was lucky enough to find myself treated to one of Robert’s epic block comments[0]. He was
by vanderZwan 7y ago
> I read a lot of code too, which wasn’t always easy, but sometimes I was lucky enough to find myself treated to one of Robert’s epic block comments[0].
He wasn't exaggerating, that is an epic, beautiful, I would even say humbling block comment to read. It's completely outside of my regular knowledge domain but that is not at all required to appreciate it.
[0] https://github.com/joyent/illumos-joyent/blob/dff0473c792fc5c3ef7c3d862e557fe201a5d671/usr/src/uts/common/io/mac/mac_sched.c#L28-L967 https://github.com/joyent/illumos-joyent/blob/dff0473c792fc5...
- techslave 7y agoit’s a horrible comment. OTOH it’s world class documentation. obviously i’m not comparing myself, but i often find myself the only one at my $JOB that documents things at similar level. 99% of the time because i’m touching code i don’t understand and need to understand it first. writing the doco is the way i do it. software would be soooo much better if we lived in a world where a) engineering practice demanded devs document this well, and b) the majority of devs had the skill to write so well. market pressure however demands faster delivery times, and who cares about the tech debt.