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.
54 lines
1.1 KiB
Plaintext
54 lines
1.1 KiB
Plaintext
== Why is this an issue?
|
|
|
|
Shared coding conventions allow teams to collaborate efficiently. This rule checks that all namespace names match a provided regular expression.
|
|
|
|
|
|
The default configuration is the one recommended by Microsoft:
|
|
|
|
* Pascal casing, starting with an upper case character, e.g. Microsoft, System
|
|
* Short abbreviations of 2 letters can be capitalized, e.g. System.IO
|
|
* Longer abbreviations need to be lower cased
|
|
|
|
=== Noncompliant code example
|
|
|
|
With the default regular expression: ``++^([A-Z]{1,3}[a-z0-9]+)*([A-Z]{2})?(\.([A-Z]{1,3}[a-z0-9]+)*([A-Z]{2}))*$++``
|
|
|
|
[source,vbnet]
|
|
----
|
|
Namespace foo ' Noncompliant
|
|
End Namespace
|
|
----
|
|
|
|
=== Compliant solution
|
|
|
|
[source,vbnet]
|
|
----
|
|
Namespace Foo ' Compliant
|
|
End Namespace
|
|
----
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
=== Message
|
|
|
|
Rename this namespace to match the regular expression "rrr".
|
|
|
|
|
|
=== Parameters
|
|
|
|
.format
|
|
****
|
|
|
|
----
|
|
^([A-Z]{1,3}[a-z0-9]+)*([A-Z]{2})?(\.([A-Z]{1,3}[a-z0-9]+)*([A-Z]{2}))*$
|
|
----
|
|
|
|
Regular expression used to check the namespace names against.
|
|
****
|
|
|
|
|
|
endif::env-github,rspecator-view[]
|