docs(dom-to-react): tidy comments and update JSDoc

Author: remarkablemark

lib/dom-to-react.js

@@ -35,7 +35,7 @@ function domToReact(nodes, options) {
       replaceElement = options.replace(node);
 
       if (isValidElement(replaceElement)) {
-        // specify a "key" prop if element has siblings
+        // set "key" prop for sibling elements
         // https://fb.me/react-warning-keys
         if (len > 1) {
           replaceElement = cloneElement(replaceElement, {
@@ -62,14 +62,11 @@ function domToReact(nodes, options) {
 
     props = node.attribs;
     if (!shouldPassAttributesUnaltered(node)) {
-      // update values
       props = attributesToProps(node.attribs);
     }
 
     children = null;
 
-    // node type for <script> is "script"
-    // node type for <style> is "style"
     if (node.type === 'script' || node.type === 'style') {
       // prevent text in <script> or <style> from being escaped
       // https://facebook.github.io/react/tips/dangerously-set-inner-html.html
@@ -94,7 +91,7 @@ function domToReact(nodes, options) {
       continue;
     }
 
-    // specify a "key" prop if element has siblings
+    // set "key" prop for sibling elements
     // https://fb.me/react-warning-keys
     if (len > 1) {
       props.key = i;
@@ -107,6 +104,8 @@ function domToReact(nodes, options) {
 }
 
 /**
+ * Determines whether attributes should be altered or not.
+ *
  * @param {React.ReactElement} node
  * @return {Boolean}
  */