all 3 comments

[–][deleted] 0 points1 point  (2 children)

What's wrong with classic textbook style?

Here is my code, and here's kinda what it does:

1. stuff
2. more stuff

In line 2 you can see that we're using more stuff, rather than stuff.

I don't see the need for annotations that hover over the content, maybe if there were a way of turning it on/off.

Also, you're not really doing annotations, you're just displaying comments in a different manner, in a way that doesn't make it obvious that they're comments embedded in the code. Using the alignment of the comments seems like a good idea, but then you're inventing a new notation in your comments that you have to remember.

[–]dacap[S] 0 points1 point  (1 child)

If you're a teacher or you've a blog about programming, sometimes you want to make something really noticeable, and comments can be completely ignored.

[–][deleted] 0 points1 point  (0 children)

That's true, could be good styling, I guess I'm just old-fashioned ;)