Fix dead at-links in comments

Author: pluma

src/collection.ts

@@ -408,7 +408,7 @@ export type CollectionKeyOptions = {
  * Options for creating a collection.
  *
  * See {@link Database.createCollection}, {@link Database.createEdgeCollection}
- * and {@link Collection.create}.
+ * and {@link DocumentCollection.create} or {@link EdgeCollection.create}.
  */
 export type CreateCollectionOptions = {
   /**

src/database.ts

@@ -1857,7 +1857,11 @@ export class Database {
 
   //#region collections
   /**
-   * Returns a {@link Collection} instance for the given collection name.
+   * Returns a `Collection` instance for the given collection name.
+   *
+   * In TypeScript the collection implements both the
+   * {@link DocumentCollection} and {@link EdgeCollection} interfaces and can
+   * be cast to either type to enforce a stricter API.
    *
    * @param T - Type to use for document data. Defaults to `any`.
    * @param collectionName - Name of the edge collection.
@@ -2017,7 +2021,7 @@ export class Database {
   /**
    * Renames the collection `collectionName` to `newName`.
    *
-   * Additionally removes any stored {@link Collection} instance for
+   * Additionally removes any stored `Collection` instance for
    * `collectionName` from the `Database` instance's internal cache.
    *
    * **Note**: Renaming collections may not be supported when ArangoDB is
@@ -2080,7 +2084,11 @@ export class Database {
 
   /**
    * Fetches all collections from the database and returns an array of
-   * {@link Collection} instances.
+   * `Collection` instances.
+   *
+   * In TypeScript these instances implement both the
+   * {@link DocumentCollection} and {@link EdgeCollection} interfaces and can
+   * be cast to either type to enforce a stricter API.
    *
    * See also {@link Database.listCollections}.
    *
@@ -2377,7 +2385,7 @@ export class Database {
    * value.
    *
    * Collections can be specified as collection names (strings) or objects
-   * implementing the {@link ArangoCollection} interface: {@link Collection},
+   * implementing the {@link ArangoCollection} interface: `Collection`,
    * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
    * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
    *
@@ -2430,7 +2438,7 @@ export class Database {
    * Performs a server-side transaction and returns its return value.
    *
    * Collections can be specified as collection names (strings) or objects
-   * implementing the {@link ArangoCollection} interface: {@link Collection},
+   * implementing the {@link ArangoCollection} interface: `Collection`,
    * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
    * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
    *
@@ -2479,7 +2487,7 @@ export class Database {
    * Performs a server-side transaction and returns its return value.
    *
    * The Collection can be specified as a collection name (string) or an object
-   * implementing the {@link ArangoCollection} interface: {@link Collection},
+   * implementing the {@link ArangoCollection} interface: `Collection`,
    * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
    * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
    *
@@ -2573,7 +2581,7 @@ export class Database {
    * a {@link Transaction} instance for the transaction.
    *
    * Collections can be specified as collection names (strings) or objects
-   * implementing the {@link ArangoCollection} interface: {@link Collection},
+   * implementing the {@link ArangoCollection} interface: `Collection`,
    * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
    * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
    *
@@ -2603,7 +2611,7 @@ export class Database {
    * a {@link Transaction} instance for the transaction.
    *
    * Collections can be specified as collection names (strings) or objects
-   * implementing the {@link ArangoCollection} interface: {@link Collection},
+   * implementing the {@link ArangoCollection} interface: `Collection`,
    * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
    * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
    *
@@ -2634,7 +2642,7 @@ export class Database {
    * a {@link Transaction} instance for the transaction.
    *
    * The Collection can be specified as a collection name (string) or an object
-   * implementing the {@link ArangoCollection} interface: {@link Collection},
+   * implementing the {@link ArangoCollection} interface: `Collection`,
    * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
    * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
    *

src/graph.ts

@@ -367,7 +367,7 @@ export type GraphCreateOptions = {
 };
 
 /**
- * Represents a {@link Collection} of vertices in a {@link Graph}.
+ * Represents a {@link DocumentCollection} of vertices in a {@link Graph}.
  *
  * @param T - Type to use for document data. Defaults to `any`.
  */
@@ -774,7 +774,7 @@ export class GraphVertexCollection<T extends object = any>
 }
 
 /**
- * Represents a {@link Collection} of edges in a {@link Graph}.
+ * Represents a {@link EdgeCollection} of edges in a {@link Graph}.
  *
  * @param T - Type to use for document data. Defaults to `any`.
  */

src/transaction.ts

@@ -172,8 +172,8 @@ export class Transaction {
    * @param callback - Callback function returning a promise.
    *
    * **Warning**: The callback function should wrap a single call of an async
-   * arangojs method (e.g. a method on a {@link Collection} object of a
-   * collection that is involved in the transaction or the `db.query` method).
+   * arangojs method (e.g. a method on a `Collection` object of a collection
+   * that is involved in the transaction or the `db.query` method).
    * If the callback function is async, only the first promise-returning (or
    * async) method call will be executed as part of the transaction. See the
    * examples below for how to avoid common mistakes when using this method.