51369b610e
When an include is not surrounded by empty lines, its content is inlined on the same line as the adjacent content. That can lead to broken tags and other display issues. This PR fixes all such includes and introduces a validation step that forbids introducing the same problem again.
42 lines
1.1 KiB
Plaintext
42 lines
1.1 KiB
Plaintext
== Why is this an issue?
|
|
|
|
Loggers should be:
|
|
|
|
* ``++private++``: not accessible outside of their parent classes. If another class needs to log something, it should instantiate its own logger.
|
|
* ``++static++``: not dependent on an instance of a class (an object). When logging something, contextual information can of course be provided in the messages but the logger should be created at class level to prevent creating a logger along with each object.
|
|
* ``++const++``: created once and only once per class.
|
|
|
|
=== Noncompliant code example
|
|
|
|
With the default regular expression ``++LOG(?:GER)?++``:
|
|
|
|
[source,flex]
|
|
----
|
|
public const logger:ILogger = LogUtil.getLogger(MyClass);
|
|
----
|
|
|
|
=== Compliant solution
|
|
|
|
[source,flex]
|
|
----
|
|
private static const LOG:ILogger = LogUtil.getLogger(MyClass);
|
|
----
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
include::../message.adoc[]
|
|
|
|
include::../parameters.adoc[]
|
|
|
|
'''
|
|
== Comments And Links
|
|
(visible only on this page)
|
|
|
|
include::../comments-and-links.adoc[]
|
|
|
|
endif::env-github,rspecator-view[]
|