News for hackers. Stuff that matters.
Re:How to annotate everything by retsibsi on Thursday November 28, 2019 @02:43AM (#21655364)
Not trying to be a smartarse, but isn't that what comments are for? If they aid your comprehension, there's a reasonable chance they'll also help someone else in the future.
Re:How to annotate everything by TeMPOraL on Thursday November 28, 2019 @02:55AM (#21655410)
There's overlap, but annotations are more throwaway and task-oriented. Once done with your code study, you wouldn't want to commit to the main repo all the little yellow highlights, the "!!!" notes, the hand-drawn arrows connecting code lines, the "does X, but ask Fred" remarks, etc.

Also, separating these out would let one to design tooling that's more suitable for reading and annotating than editing. When studying code, I'd prefer to do it on a tablet, with an experience closer to a PDF reader than IDE.

Re:How to annotate everything by retsibsi on Friday November 29, 2019 @11:12PM (#21668463)
That makes sense, thanks.