Add test case for links to function overloads

Author: octogonz

build-tests/api-documenter-test/etc/api-documenter-test.api.json

@@ -99,7 +99,7 @@
         {
           "kind": "Class",
           "canonicalReference": "api-documenter-test!DocClass1:class",
-          "docComment": "/**\n * This is an example class.\n *\n * @remarks\n *\n * These are some remarks.\n *\n * The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DocClass1` class.\n *\n * @defaultValue\n *\n * a default value for this function\n *\n * {@docCategory DocClass1}\n *\n * @public\n */\n",
+          "docComment": "/**\n * This is an example class.\n *\n * @remarks\n *\n * {@link DocClass1.(exampleFunction:1) | Link to overload 1}\n *\n * {@link DocClass1.(exampleFunction:2) | Link to overload 2}\n *\n * {@docCategory DocClass1}\n *\n * The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DocClass1` class.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

build-tests/api-documenter-test/etc/markdown/api-documenter-test.docclass1.md

@@ -14,7 +14,10 @@ export declare class DocClass1 extends DocBaseClass implements IDocInterface1, I
 
 ## Remarks
 
-These are some remarks.
+[Link to overload 1](./api-documenter-test.docclass1.examplefunction.md)
+
+[Link to overload 2](./api-documenter-test.docclass1.examplefunction_1.md)
+
 
 The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DocClass1` class.
 

build-tests/api-documenter-test/etc/yaml/api-documenter-test/docclass1.yml

@@ -3,7 +3,11 @@ items:
   - uid: 'api-documenter-test!DocClass1:class'
     summary: This is an example class.
     remarks: >-
-      These are some remarks.
+      [Link to overload 1](xref:api-documenter-test!DocClass1#exampleFunction:member(1))
+
+
+      [Link to overload 2](xref:api-documenter-test!DocClass1#exampleFunction:member(2))
+
 
 
       The constructor for this class is marked as internal. Third-party code should not call the constructor directly or

build-tests/api-documenter-test/src/DocClass1.ts

@@ -140,8 +140,10 @@ export interface IDocInterface4 {
  * This is an example class.
  *
  * @remarks
- * These are some remarks.
- * @defaultValue a default value for this function
+ * {@link DocClass1.(exampleFunction:1)|Link to overload 1}
+ *
+ * {@link DocClass1.(exampleFunction:2)|Link to overload 2}
+ *
  * @public
  * {@docCategory DocClass1}
  */