4 ms·
I think it's not just "strong wording", but the inarticulateness of the first example comment. You can express strong feelings while still being articulate. E
by DarkShikari 15y ago
I think it's not just "strong wording", but the inarticulateness of the first example comment. You can express strong feelings while still being articulate.
Example 1: //FIXME: This code is shit, someone make it better.
Example 2: //FIXME: This code is a truly atrocious hack to work around $issue. I don't know of a better way, but suggestions welcome.
- astine 15y agoWhats the different between example two and this: //FIXME: This code is a shitty hack to work around $issue. I don't know of a better way, but suggestions welcome. This contains the same information but uses a swearword. I think that every would agree that clearer comments are better, but does the presence of obscenities inhibit clarity or are they merely offensive and superfluous?
- awj 15y ago> but does the presence of obscenities inhibit clarity That entirely depends on your work environment. Will adding in obscenities will rouse up some big HR kerfuffle? Then don't do it, you're just wasting everyone's time. Otherwise, do whatever you want.