Patterns in confusing explanations

#documentation, #pattern

Grok | Code-centric Documentation

#documentation

Why programmers don’t write documentation | Kislay Verma

#documentation

Explaining Code using ASCII Art – Embedded in Academia

#ascii, #ascii-art, #code, #documentation, #formatting

Explaining Code using ASCII Art – Embedded in Academia

#ascii, #ascii-art, #code, #documentation, #formatting

Chris Lattner on the origins of Swift – Ole Begemann

I’ve seen so many systems where you build a thing and then you try to explain it afterwards. And when you go to explain it and it’s really awkward and you’re like, “wow, I have to explain the workarounds for this thing”. If you can close that feedback loop and include the documentation, include the explaining-it-to-people part into the design process, you get something that’s so much better.

#documentation

Chris Lattner on the origins of Swift – Ole Begemann

I’ve seen so many systems where you build a thing and then you try to explain it afterwards. And when you go to explain it and it’s really awkward and you’re like, “wow, I have to explain the workarounds for this thing”. If you can close that feedback loop and include the documentation, include the explaining-it-to-people part into the design process, you get something that’s so much better.

#documentation

Writing and Maintaining Good Code Documentation | Inside PSPDFKit

#documentation

Writing and Maintaining Good Code Documentation | Inside PSPDFKit

#documentation

Spring REST Docs – Test driven documentation of your REST API | Vojtech Ruzicka’s Programming Blog

Spring REST Docs – Test driven documentation of your REST API | Vojtech Ruzicka’s Programming Blog

#documentation, #rest, #spring