The code vocabulary frequency may be too low
This code insight – a derived metric from Halstead complexity measures – evaluates if a source file has a correct level of keyword variety (i.e. the ratio between the total number of operators/operand and the number of distinct operators/operands). If this ratio is high, it means your code could be semantically poor and globally harder to understand. Depending on Halstead recommendations and thresholds defined by CAST and based on an experience of 25 years in software measurement, Highlight counts penalty points for the scanned file if the vocabulary frequency is too low.
Why you should care
Understanding what a piece of code is supposed to do relies on many aspects like documentation, good naming conventions, etc. The vocabulary frequency can also help developers to understand and maintain the code more easily. Ensuring your software has a well-balanced number of different keywords that a programming language offers tends to reduce the time necessary for a developer to handle it efficiently – especially if he’s not the primary code author.
About CAST and Highlight’s Code Insights
Over the last 25 years, CAST has leveraged unique knowledge on software quality measurement by analyzing thousands of applications and billions of lines of code. Based on this experience and community standards on programming best practices, Highlight implements hundreds of code insights across 15+ technologies to calculate health factors of a software.