3 ms·
Reading this and thinking of the dozen .md documents in my repo that are sooo badly out of date they're actually misleading. I apologise to anyone who ever has
by marcus_holmes 7y ago
Reading this and thinking of the dozen .md documents in my repo that are sooo badly out of date they're actually misleading.
I apologise to anyone who ever has to read my documentation. I'm really, truly, sorry. I have excuses but no reasons.
- jenscow 7y agoCould you please share your excuses, so we can all use them? :)
- mpol 7y agoI do feel for you :) but at the same time I think Markdown, the tool, is not to blame for this. I write most of my documentation in Markdown or just plain text files. The reason is simple, I want the same focus that I had when writing the code. Doing a context switch from code/IDE to html/Web is a nightmare for me. If that would be mandatory for some reason, my documentation would suffer from more bitrot then it does now.