01:16 <chadmed> Sobek[m]: are you saying your lecturer thinks documentation is only required when your code sucks?

01:20 <chadmed> thats a pretty evil attitude to have, especially for low level stuff. we all like to think we write perfect unambiguous human-readable code but... we dont

01:41 <alyssa> chadmed: ah that's where you're wrong, 100% of the code I've written recently has sucked :3

01:41 <alyssa> at least on some axis

01:41 <alyssa> I think I just hate code now? :p

01:43 <matthewayers[m]> chadmed: I agree. Documentation is extremely important for any kind of software engineering because it shows that you’re not only understand the code, but you can explain it to others in a way that makes sense and will ensure the maintainability of that code for years to come.

05:31 <Sobek[m]> <chadmed> "Sobek: are you saying your..." <- Nah, the OS staff would print our code, read every single line of it and use copious amount of red ink. They had high expectations on documentation quality (especially design documentation, documenting what isn’t in the code, such as why is the design the way it is)

05:34 <Sobek[m]> (I don’t remember if it was the prof or one of the TAs (now working at a fruit company) that said that he taught us the way he did because some of us where very likely to write code he would end up running. I had a friend from that class who discussed recently the nvidia driver saying « oh that piece of code I started as an intern » so that prediction is pretty true too)

05:35 <chadmed> oh good

15:49 <alyssa> ok sure stream let's do this

15:54 <alyssa> On air https://twitch.tv/asahigpu ~

18:26 <Dcow[m]> alyssa: thank you for the stream