Document createGenericPropertyDescriptor

Closes #280.

Author: domenic

lib/utils/propertyDescriptors.js

@@ -6,10 +6,12 @@ const parsers = require("../parsers");
 const { AST_TYPES } = parsers;
 
 /**
- * Creates a generic property descriptor for a CSS property.
+ * Creates a generic property descriptor for a given property. Such descriptors are used whenever we don't have a
+ * specific handler in `./properties/*.js`. They perform some basic logic that works as a fallback, and is correct for
+ * simple properties, but properties with more complex grammars will need their own handlers.
  *
- * @param {string} property - The name of the CSS property.
- * @returns {object} The property descriptor object.
+ * @param {string} property - The canonical CSS property name (e.g. "backdrop-filter", not "backdropFilter").
+ * @returns {Object} The property descriptor object.
  */
 function createGenericPropertyDescriptor(property) {
   return {