Add additional comments for scala detection

Author: nr-kateanderson

newrelic-agent/src/main/java/com/newrelic/agent/language/SourceLibraryDetector.java

@@ -92,7 +92,7 @@ private void detectJava() {
 
     private void detectScala3(ClassLoader systemClassLoader) {
         try {
-            //scala3-library removed all methods referencing the version number, so we just capture the major version
+            //scala3-library removed all methods referencing the version 3 number, so we only capture the major version
             //by checking for a class introduced in the scala 3 API.
             Class<?> aClass = Class.forName("scala.deriving.Mirror", true, systemClassLoader);
             if (aClass != null) {
@@ -107,7 +107,8 @@ private void detectScala3(ClassLoader systemClassLoader) {
 
     private void detectScala(ClassLoader systemClassLoader) {
         try {
-            // Scala has a static versionNumberString method that can be invoked to get the version number
+            // Scala has a static versionNumberString method that can be invoked to get the version number.
+            // A scala 3 app will also capture this metric, because scala 3 includes the scala 2.13 library.
             Class<?> aClass = Class.forName(SCALA_VERSION_CLASS, true, systemClassLoader);
             if (aClass != null) {
                 String version = (String) aClass.getMethod(SCALA_VERSION_METHOD).invoke(null);