2 ms·

Tangent, is it a Swift thing to have "* ################################################################## / comment markers ? It becomes quickly very visually

Tangent, is it a Swift thing to have "* ################################################################## / comment markers ? It becomes quickly very visually dominant in the source code: > / ###################################################################################################################################### / // MARK: - PUBLIC BASE CLASS OVERRIDES - / ###################################################################################################################################### */

ChrisMarshallNY 1y ago
Nope. It's a "Me" thing. I write code that I want to see. I have fairly big files, and it makes it easy to scroll through, quickly. It also displays well, when compiling with docc or Jazzy. My comment/blank line-to-code ratio is about 50/50. Most of my comments are method/function/property headerdoc/docc labels. Here's the cloc on the middle project: github.com/AlDanial/cloc v 2.04 T=0.03 s (1319.9 files/s, 468842.4 lines/s) ------------------------------------------------------------------------------- Language files blank comment code ------------------------------------------------------------------------------- Swift 33 1737 4765 5220 ------------------------------------------------------------------------------- SUM: 33 1737 4765 5220 -------------------------------------------------------------------------------
mackeye 1y ago
i see lots of python with blocks like ############################################################################### ############################### LIBRARY IMPORTS ############################### ############################################################################### import sys from pathlib import Path (not in this case but) it helps me for long files where modularization would be inconvenient

ChrisMarshallNY 1y ago

Nope. It's a "Me" thing. I write code that I want to see. I have fairly big files, and it makes it easy to scroll through, quickly. It also displays well, when compiling with docc or Jazzy. My comment/blank line-to-code ratio is about 50/50. Most of my comments are method/function/property headerdoc/docc labels. Here's the cloc on the middle project: github.com/AlDanial/cloc v 2.04 T=0.03 s (1319.9 files/s, 468842.4 lines/s) ------------------------------------------------------------------------------- Language files blank comment code ------------------------------------------------------------------------------- Swift 33 1737 4765 5220 ------------------------------------------------------------------------------- SUM: 33 1737 4765 5220 -------------------------------------------------------------------------------

mackeye 1y ago

i see lots of python with blocks like ############################################################################### ############################### LIBRARY IMPORTS ############################### ############################################################################### import sys from pathlib import Path (not in this case but) it helps me for long files where modularization would be inconvenient