Hacker News new | ask | show | jobs
by knorker 823 days ago
Whenever I've made notes like this, it's never been useful to my future self nor to anyone else.

The only use I've had of this kind of documentation is that the process of writing it, made me understand it better. Basically write-only documentation.

I would call myself a Linux expert, and while I can kinda see what you mean with this diagram, it would not have been useful to me back before I was an expert.

3 comments

Usually I would agree. I typically make a "Crash-Course in $PLATFORM" document while keeping notes. These I very commonly reference in order to externalize my memory since it seems to be approaching capacity. I don't care about Ruby on Rails, but once I did, and I can reference my notes if I ever need to touch that platform again.
It almost resembles mind mapping. It is a useful ‘process’ to figure out what you think/know. And it might be a pretty picture. But it isn’t very useful as documentation.
I found it useful. Allowed me to compare if I have similar idea to the author.