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.
57 lines
1.2 KiB
Plaintext
57 lines
1.2 KiB
Plaintext
== Why is this an issue?
|
||
|
||
Although unnecessary won't change anything to the produced application, removing them:
|
||
|
||
* Will help readability and maintenance.
|
||
* Will help reduce the number of items in the IDE auto-completion list when coding.
|
||
* May avoid some name collisions.
|
||
* May improve compilation time because the compiler has fewer namespaces to look-up when it resolves types.
|
||
|
||
=== Noncompliant code example
|
||
|
||
[source,vbnet]
|
||
----
|
||
Imports System.Collections.Generic // Noncompliant - unnecessary using
|
||
|
||
Module Module1
|
||
Sub Main(path As String)
|
||
File.ReadAllLines(path);
|
||
End Sub
|
||
End Module
|
||
----
|
||
|
||
=== Compliant solution
|
||
|
||
[source,vbnet]
|
||
----
|
||
Imports System.IO
|
||
|
||
Module Module1
|
||
Sub Main(path As String)
|
||
File.ReadAllLines(path);
|
||
End Sub
|
||
End Module
|
||
----
|
||
|
||
ifdef::env-github,rspecator-view[]
|
||
|
||
'''
|
||
== Implementation Specification
|
||
(visible only on this page)
|
||
|
||
include::../message.adoc[]
|
||
|
||
'''
|
||
== Comments And Links
|
||
(visible only on this page)
|
||
|
||
=== on 23 Sep 2019, 16:33:48 Nicolas Harraudeau wrote:
|
||
*OUT OF SCOPE*
|
||
|
||
|
||
Duplicate imports are out of scope as dotnet won't even compile code in this case.
|
||
|
||
include::../comments-and-links.adoc[]
|
||
|
||
endif::env-github,rspecator-view[]
|