Added a comment

D4N14L · Sep 8, 2022 · 1e11c5c · 1e11c5c
1 parent 97e4593
commit 1e11c5c
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/apps/api-extractor/src/generators/DeclarationReferenceGenerator.ts b/apps/api-extractor/src/generators/DeclarationReferenceGenerator.ts
@@ -272,6 +272,9 @@ export class DeclarationReferenceGenerator {
     const declaration: ts.Node | undefined = TypeScriptHelpers.tryGetADeclaration(symbol);
     const sourceFile: ts.SourceFile | undefined = declaration?.getSourceFile();
 
+    // Note that it's possible for a symbol to be exported from an entry point as well as one or more
+    // namespaces. In that case, it's not clear what to choose as its parent. Today's logic is neither
+    // perfect nor particularly stable to API items being renamed and shuffled around.
     const entity: CollectorEntity | undefined = this._collector.tryGetEntityForSymbol(symbol);
     if (entity) {
       if (entity.exportedFromEntryPoint) {