
In some cases, the `rule.adoc` at root of a rule is never included anywhere and thus is dead code. It's a maintenance cost by itself, but also it misses opportunities to inline code that seems used by two documents when in fact only one document is actually rendered. And this missed opportunity, in turn, stops us from applying the correct language tag on the code samples.
44 lines
677 B
Plaintext
44 lines
677 B
Plaintext
== Why is this an issue?
|
|
|
|
include::../description.adoc[]
|
|
|
|
include::../noncompliant.adoc[]
|
|
|
|
=== Compliant solution
|
|
|
|
[source,java]
|
|
----
|
|
public interface Nothing {
|
|
}
|
|
----
|
|
|
|
|
|
=== Exceptions
|
|
|
|
Empty classes can be used as marker types (for Spring for instance), therefore empty classes that are annotated will be ignored.
|
|
|
|
[source,java]
|
|
----
|
|
@Configuration
|
|
@EnableWebMvc
|
|
public final class ApplicationConfiguration {
|
|
|
|
}
|
|
----
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
include::../message.adoc[]
|
|
|
|
'''
|
|
== Comments And Links
|
|
(visible only on this page)
|
|
|
|
include::../comments-and-links.adoc[]
|
|
|
|
endif::env-github,rspecator-view[]
|