Background or reasoning for error: TsLint: comment must start with lowercase letter

11
votes

I'm getting the following TsLint message in my project:

TsLint: comment must start with lowercase letter

Is there any grounding behind this? I agree with most of what I've come across in TsLint, and I'm aware of the ability to turn this warning off.

I'd rather understand why they suggest this particular rule. I read the docs at https://github.com/palantir/tslint#supported-rules which explain what the rule does but not why.

2
commentstypescripttslint
I don't use Typescript, but I suspect there's a coding convention that makes special use of comments that start with capitals. – Barmar
According to check-in history at github.com/palantir/tslint/commit/… this rule was introduced by github.com/gscshoyru on Dec 2, 2013. Asking this question at the source might be the best way to get your answer – xmojmr

2 Answers

15
votes

I asked the author on this one.

This is just a style rule, and can safely be ignored if it's not needed

Personally speaking, I can think of no reason to enforce this rule so I recommend disabling it or ignoring it.

0
votes

add this rule to your tslint.json:

"comment-format": [false, "check-uppercase"]