rspec/rules/S1176/comments-and-links.adoc

43 lines
1.7 KiB
Plaintext
Raw Normal View History

=== On 2013-08-02T15:29:42Z Freddy Mallet Wrote:
Is implemented by \https://jira.codehaus.org/browse/SONARJAVA-219
=== On 2013-08-15T14:38:48Z Dinesh Bolkensteyn Wrote:
For some reason, public static final members were previously excluded.
I removed that exclusion to be in sync with the description, and because I don't see why those should be excluded in the first place.
=== On 2013-08-16T11:42:25Z Dinesh Bolkensteyn Wrote:
As discussed, public static final fields are excluded from public API because they are usually self descriptive and do not need to be documented.
=== On 2016-07-21T15:37:55Z Freddy Mallet Wrote:
\[~ann.campbell.2], as discussed with [~nicolas.peru] today, this rule generates some noise/controverses out of the box and even with **.api.** as default value for parameter forClasses. So we would suggest to remove it from the "Sonar way" quality profile.
=== On 2016-07-21T15:46:14Z Ann Campbell Wrote:
done [~freddy.mallet]
=== On 2017-12-05T02:10:16Z yuhan Wrote:
{color:red}At least 1 line of description which should have more than one word.{color}
if the description is not engilish,may not have space.such as
/**
* 将字节转为字符(解码)
*
* @param bytes 字节数组
* @return 字符数组
*/
{empty}.is's a bug??
=== On 2017-12-08T15:43:54Z Jean-Christophe Collet Wrote:
\[~yuhan0501] That particular section of the rule has been relaxed in SonarJava 4.13 (it doesn't check the number of words any longer) but we forgot to update the RSPEC itself, I apologise for that oversight. I now have updated the RSPEC to reflect that decision.
And you are right, previous implementation had a bug where it ignored localisation.
Best regards