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.
30 lines
603 B
Plaintext
30 lines
603 B
Plaintext
== Why is this an issue?
|
|
|
|
An include that grows too much tends to aggregate too many responsibilities and inevitably becomes harder to understand and therefore to maintain. Above a specific threshold, it is strongly advised to refactor the include into smaller ones which focus on well-defined topics.
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
=== Message
|
|
|
|
Split this include into smaller modules
|
|
|
|
|
|
=== Parameters
|
|
|
|
.maximumLineIncludeThreshold
|
|
****
|
|
|
|
----
|
|
200
|
|
----
|
|
|
|
The maximum number of lines of code
|
|
****
|
|
|
|
|
|
endif::env-github,rspecator-view[]
|