Amended comments.

Author: DanielRosenwasser

src/services/services.ts

@@ -6997,8 +6997,12 @@ namespace ts {
  * Checks if position points to a valid position to add JSDoc comments, and if so,
  * returns the appropriate template. Otherwise returns an empty string.
  * Valid positions are
- * - outside of comments, statements, and expressions, and
- * - preceding a function declaration.
+ * - outside of comments, statements, and expressions, and
+ * - preceding a:
+ * - function/constructor/method declaration
+ * - class declarations
+ * - variable statements
+ * - namespace declarations
  *
  * Hosts should ideally check that:
  * - The line is all whitespace up to 'position' before performing the insertion.
@@ -7041,7 +7045,9 @@ namespace ts {
  case SyntaxKind.SourceFile:
  return undefined;
  case SyntaxKind.ModuleDeclaration:
- // We don't want to give back a JSDoc for the 'b' in 'module a.b'.
+ // If in walking up the tree, we hit a a nested namespace declaration,
+ // then we must be somewhere within a dotted namespace name; however we don't
+ // want to give back a JSDoc template for the 'b' or 'c' in 'namespace a.b.c { }'.
  if (commentOwner.parent.kind === SyntaxKind.ModuleDeclaration) {
  return undefined;
  }