Apply suggestions from code review

Signed-off-by: Athan <[email protected]>

Author: kgryte

lib/node_modules/@stdlib/_tools/eslint/rules/no-unnecessary-nested-functions/lib/main.js

@@ -149,7 +149,7 @@ function referencesOuterVariables( node, context ) {
 * @private
 * @param {string} varName - variable name
 * @param {Object} startScope - scope to start searching from
-* @returns {Object|null} scope where variable is defined or null if not found
+* @returns {(Object|null)} scope where variable is defined or null if not found
 */
 function findVariableScope( varName, startScope ) {
 	var currentScope;
@@ -177,7 +177,7 @@ function findVariableScope( varName, startScope ) {
 * @private
 * @param {ASTNode} node - function declaration node
 * @param {Object} context - ESLint context
-* @returns {Object|null} highest scope object or null if cannot be moved
+* @returns {(Object|null)} highest scope object or null if cannot be moved
 */
 function getHighestPossibleScope( node, context ) {
 	var parentFuncScope;
@@ -200,8 +200,7 @@ function getHighestPossibleScope( node, context ) {
 		highestScope = highestScope.upper;
 	}
 
-	// If we're already at module level, we still want to check if we can move there
-	// (This handles the case where the function is directly nested in a top-level function)
+	// If we're already at module level, we still want to check if we can move there (note: this handles the case where the function is directly nested in a top-level function)...
 
 	// Check all references in this function's scope...
 	for ( i = 0; i < currentScope.references.length; i++ ) {