update code-comment to be less confusing

Author: mansona

lib/frontmatter-linter.js

@@ -29,7 +29,9 @@ module.exports = class FrontmatterLinter {
         required: true,
         conform: function (value) {
           const result = value?.every((item) => teams.includes(item));
-          // we need to warn like this because revalidator doesn't allow custom messages
+          // we need to warn like this because revalidator doesn't allow you to use specific
+          // context in custom messages. i.e. it will tell you that there an unmatched team
+          // but it won't tell you which one is the offending team.
           if (!result) {
             console.warn(`Invalid team in ${value}. Available teams: ${teams}`);
           }