A funny story with regards to the first point : We have some legacy code at my work which is basically in "do not touch or it'll break" mode. Last year a senio

A funny story with regards to the first point : We have some legacy code at my work which is basically in "do not touch or it'll break" mode. Last year a senior developer who used to maintain it retired. Before he left, he copied the code into a PDF and annotated the PDF with his thoughts and advice. He didn't want to risk breaking the code on his last week by adding the comments directly to the code.