15 ms·
I forget where I saw this, but it struck me as very good advice: Don't document your code, code your documentation.
by wck0 8y ago
I forget where I saw this, but it struck me as very good advice: Don't document your code, code your documentation.
- iamdave 8y agoI like that. So many times I've looked at a peer's code and had a hard time reconciling what the comments and wiki articles said with what their code was attempting to do. This mindset is probably a godsend to QA teams.
- cbcoutinho 8y agoSounds like literate programming, popularized by Donald Knuth
- madhadron 8y agoMy father was convinced that Quark XPress was written that way: once they had the core functionality figured out, they wrote the manual, then implemented it.
- bitL 8y agoThe thing is - this is interesting because nobody is doing it anymore. Once everybody starts doing it, i.e. literally "human politics" gets directly involved on all levels of development, everybody would try to escape this style to get some development freedom for themselves to stay sane.