16f6c0aecf
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.
42 lines
648 B
Plaintext
42 lines
648 B
Plaintext
== Why is this an issue?
|
|
|
|
Using a type parameter when you don't have to simply obfuscates the code. Qualifying an inner type with a type parameter will compile, but confuse maintainers.
|
|
|
|
|
|
=== Noncompliant code example
|
|
|
|
[source,java]
|
|
----
|
|
<T extends Map> T doTheThing(T.Entry type) { // Noncompliant
|
|
//...
|
|
}
|
|
----
|
|
|
|
|
|
=== Compliant solution
|
|
|
|
[source,java]
|
|
----
|
|
<T extends Map> T doTheThing(Map.Entry type) {
|
|
//...
|
|
}
|
|
----
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
=== Message
|
|
|
|
Use "xxx" here instead of "y".
|
|
|
|
|
|
=== Highlighting
|
|
|
|
Unnecessary type param
|
|
|
|
|
|
endif::env-github,rspecator-view[]
|