Fred Tingaud 16f6c0aecf
Inline adoc when include has no additional value (#1940)
Inline adoc files when they are included exactly once.

Also fix language tags because this inlining gives us better information
on what language the code is written in.
2023-05-25 14:18:12 +02:00

65 lines
1.2 KiB
Plaintext

== Why is this an issue?
Extra semicolons (``++;++``) are usually introduced by mistake, for example because:
* It was meant to be replaced by an actual statement, but this was forgotten.
* There was a typo which lead the semicolon to be doubled, i.e. ``++;;++``.
* There was a misunderstanding about where semicolons are required or useful.
=== Noncompliant code example
[source,javascript]
----
var x = 1;; // Noncompliant
function foo() {
}; // Noncompliant
----
=== Compliant solution
[source,javascript]
----
var x = 1;
function foo() {
}
----
=== Exceptions
This rule does not apply when the semicolon is after a line break and before ``++(++`` or ``++[++`` as it is often used in semicolon-less style.
[source,javascript]
----
var hello = 'Hello'
var world = 'World!'
var helloWorld = hello + ' ' + world
;[...helloWorld].forEach(c => console.log(c))
----
[source,javascript]
----
var a = 1
var b = 2 * a
;(a + b).toString()
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Remove this extra semicolon.
'''
== Comments And Links
(visible only on this page)
include::../comments-and-links.adoc[]
endif::env-github,rspecator-view[]