On: ASCII art for semantic code commenting

[roosgit]

For longer CSS files I use ASCII text to mark and visually separate the breakpoints. An advantage of this is the ability to see the breakpoints in the minimap. Something like this: https://css-tricks.com/wp-content/uploads/2015/09/mini-map.j...

There's even a Sublime Text plugin to generate this text.

[seumars → roosgit]

At that point it would be better to just split it into several files though.

[oneeyedpigeon → seumars]

Maybe it is, maybe this is just an intermediate file in a build process, optimised for readability.

[sprucevoid → roosgit]

Nice. Though it makes me think it would be nice to have this as a built in code editor minimap feature without the multi line ASCII code. The editor would parse special tags in comments and overlay the minimap with the tag text in big letters.

[KMnO4 → sprucevoid]

This is one of my favourite features of XCode. If you "// MARK:" lines, they'll show up in the minimap.

Eg. https://miro.medium.com/max/1400/1*j38oOm3Pt5AMnDI3HQ6TGQ.pn...

Screenshot stolen from this Medium[0].

[0]: https://medium.com/@mumtaz.hussain/xcode-11-now-makes-mark-c...

[sprucevoid → KMnO4]

Excellent. I hoped for a similar VS Code extension but found none. There's only Banner comments[0] to ease converting a string to large ASCII letters inline. [0]: https://marketplace.visualstudio.com/items?itemName=heyimfuz...

[unwiredben → KMnO4]

I think that might be derived from The "#pragma mark" feature that was in the CodeWarrior IDE which could be used to have annotations show in the drop-down list of functions in the code editor

[sixstringtheory → KMnO4]

And in the jump bar (^6, which is then filterable by typing) long before Xcode had the minimap!

[roosgit → sprucevoid]

Yeah, a bit like how CSSEdit used `@group` https://live.staticflickr.com/112/291326042_18115aa3c1_b.jpg