Code Comments Syntax
The cluster centers on discussions about comment syntax in programming languages, including preferences for line vs. block comments, proposals for machine-interpretable or semantic comments, and debates on whether comments should remain purely human-readable.
Activity Over Time
Top Contributors
Keywords
Sample Comments
The comment syntax is really what gets me.
Well we do have "comments" that are actually interpreted by tooling.
If by code you mean comments...
By this syntax they aren't comments anymore.
If you're feeling paranoid and don't have time to look up the set of magical incantations, maybe you should write your actual comments like this: // COMMENT we have to check that [...] :)
I think the line_comments option might be some help.
Why is the slashdash comment style an incredible idea?
Too bad the compiler doesn't raise a fatal error for comments like that.
You need to add /s to comments like these or people might mistake you for a total tool.
Line comments work pretty well for explanation storage. :) Almost every programming language support that feature.