chore: add comments

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: Planeshifter

lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-html-section-structure/lib/main.js

@@ -239,6 +239,8 @@ function linter( tree, file, options, clbk ) {
 				debug( 'Popping section stack for combined section end+comment' );
 				sectionStack.pop();
 			}
+
+			// Do not fall through to other handlers once combined case is handled...
 			return;
 		}
 
@@ -266,6 +268,8 @@ function linter( tree, file, options, clbk ) {
 			}
 
 			sectionStack.push( data );
+
+			// Don't fall through and misinterpret this node as an end tag...
 			return;
 		}
 
@@ -279,6 +283,8 @@ function linter( tree, file, options, clbk ) {
 				msg = 'Orphaned section closing tag. Found </section> without a matching opening <section> tag. Remove this tag or add a corresponding opening tag.';
 				errCode = 'orphaned-section-end';
 				reportErr( file, node, msg, errCode );
+
+				// Since there is nothing to close, do not fall through to other end-handling logic...
 				return;
 			}
 
@@ -323,6 +329,8 @@ function linter( tree, file, options, clbk ) {
 					msg = 'Missing proper empty line after closing section tag. There should be an empty line between </section> and the closing comment.';
 					errCode = 'missing-empty-line-after-section';
 					reportErr( file, node, msg, errCode );
+
+					// Fall through to still check following comment and then close section...
 				}
 
 				// Check if the following node is the expected comment:
@@ -355,7 +363,7 @@ function linter( tree, file, options, clbk ) {
 				reportErr( file, node, msg, errCode );
 			}
 
-			// Pop the section stack:
+			// Fall-throughs above are intentional: regardless of errors, pop the section stack:
 			sectionStack.pop();
 		}
 	}