Avoid PLC Procedures & Functions with a very low comment/code ratio (PL1) | CAST Appmarq

Avoid PLC Procedures & Functions with a very low comment/code ratio (PL1)


Rule Definition
Maintainability of the code is facilitated if there is documentation in the code. This rule will ensure there are comments within the Artifact

Remediation
Document your source code in order to keep a satisfactory comment/code ratio.

Violation Code Sample
….
DECLARE TEST FIXED BIN; 
….
Fixed Code Sample
….
DECLARE TEST BIN; 
….

Related Technologies

Health Factor

  Total Quality Index


Technical Criterion
Documentation - Volume of Comments

About CAST Appmarq

CAST Appmarq is by far the biggest repository of data about real IT systems. It's built on thousands of analyzed applications, made of 35 different technologies, by over 300 business organizations across major verticals. It provides IT Leaders with factual key analytics to let them know if their applications are on track.

Benchmark Statistics

Global Compliance

82.17%

Total Violations
682
Total Opportunities
3,824
Average Violations / App.
227.33
The compliance score represents 1 minus the ratio between the number of times a rule has been violated compared to the number of opportunities in a set of applications that the rule could have been violated.

Industry Insights

Financial Services

86.23%

Manufacturing

83.37%

IT & Business Consulting

100.00%