rspec/rules/S1693/cobol/rule.adoc

== Why is this an issue?

Programs that depend on a lot of different subprograms tend to aggregate too many responsibilities, and inevitably become harder to understand and therefore to maintain. Above a specific threshold, it is strongly advised to refactor the program into several smaller programs which focus on well-defined topics.


ifdef::env-github,rspecator-view[]

'''
== Implementation Specification
(visible only on this page)

=== Message

X subprograms are called, which is greater than the Y authorized.


=== Parameters

.Threshold
****

----
50
----

Maximum number of different subprograms called in a program
****


'''
== Comments And Links
(visible only on this page)

=== on 20 Mar 2015, 19:57:30 Ann Campbell wrote:
\[~pierre-yves.nicolas] does this rule raise issues for the total number of subprogram calls (i.e. if I call subprogram A 50 times) or on the number of different subprograms called (A, B, C, D, ... AA, BB, CC, DD...)

=== on 23 Mar 2015, 08:39:42 Pierre-Yves Nicolas wrote:
It's based on the number of different subprograms called.

endif::env-github,rspecator-view[]
migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`== Why is this an issue?`

Restructure one-lang rspecs 2021-04-28 16:49:39 +02:00			`Programs that depend on a lot of different subprograms tend to aggregate too many responsibilities, and inevitably become harder to understand and therefore to maintain. Above a specific threshold, it is strongly advised to refactor the program into several smaller programs which focus on well-defined topics.`
Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00
Export comments and rspec-to-rspec links from jira 2021-06-02 20:44:38 +02:00
Fix the comment display: rule-id, timestamp, GH visibility, link direction 2021-06-03 09:05:38 +02:00			`ifdef::env-github,rspecator-view[]`
RULEAPI-666: Migrate the "List of parameters", "Highlighting" and "Message" fields from jira RSPEC (#346) 2021-09-20 15:38:42 +02:00
			`'''`
			`== Implementation Specification`
			`(visible only on this page)`

Inline adoc when include has no additional value (#1940) 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. 2023-05-25 14:18:12 +02:00			`=== Message`

			`X subprograms are called, which is greater than the Y authorized.`


			`=== Parameters`

			`.Threshold`
			`****`

			`----`
			`50`
			`----`

			`Maximum number of different subprograms called in a program`
			`****`
RULEAPI-666: Migrate the "List of parameters", "Highlighting" and "Message" fields from jira RSPEC (#346) 2021-09-20 15:38:42 +02:00

RULEAPI-576: add a horizontal rule between rule description and comments 2021-06-08 15:52:13 +02:00			`'''`
Export comments and rspec-to-rspec links from jira 2021-06-02 20:44:38 +02:00			`== Comments And Links`
			`(visible only on this page)`

Inline adoc when include has no additional value (#1940) 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. 2023-05-25 14:18:12 +02:00			`=== on 20 Mar 2015, 19:57:30 Ann Campbell wrote:`
			`\[~pierre-yves.nicolas] does this rule raise issues for the total number of subprogram calls (i.e. if I call subprogram A 50 times) or on the number of different subprograms called (A, B, C, D, ... AA, BB, CC, DD...)`

			`=== on 23 Mar 2015, 08:39:42 Pierre-Yves Nicolas wrote:`
			`It's based on the number of different subprograms called.`

Fix the comment display: rule-id, timestamp, GH visibility, link direction 2021-06-03 09:05:38 +02:00			`endif::env-github,rspecator-view[]`