3 ms·
Every time you look up something on StackOverflow, refer to the API docs, or refer back to the ticket, use case, or requirements document, make a note of your q
by cratermoon 5y ago
Every time you look up something on StackOverflow, refer to the API docs, or refer back to the ticket, use case, or requirements document, make a note of your question and the answer. Even when you just stop typing to take a break, note down where you are and what you just did.
Every time you think you need a TODO comment, make a note instead, or also.
Consider Kent’s Beck’s recommendation to write down every decision you make.
Some other views
https://shannoncrabill.com/blog/taking-notes-as-a-developer/ https://shannoncrabill.com/blog/taking-notes-as-a-developer/
https://blogs.oracle.com/javamagazine/post/take-notes-as-you-codelots-of-em https://blogs.oracle.com/javamagazine/post/take-notes-as-you...
- lexicality 5y agoI know all of this, but it's still a lot of effort that I'm apparently not willing to go to. However I do at least partially do this. Whenever I use SO, I put a link to the answer in a comment next to the code that implemented it. Whenever a ticket or API doc requires doing weird stuff, I put a link to that too. Whenever I make decisions that might be slightly weird, I put a couple of paragraphs in the git commit. Not the same, but still better than nothing I guess
- cratermoon 5y ago> it's still a lot of effort that I'm apparently not willing to go to. Just like any habit, you have to start doing it, build up, and make it so you can't not do it. It's not about discipline, it's about routine.