diff --git a/src/@types/crypto.ts b/src/@types/crypto.ts
index e6383ae233..a8836d52cb 100644
--- a/src/@types/crypto.ts
+++ b/src/@types/crypto.ts
@@ -30,7 +30,7 @@ interface Extensible {
 
 /* eslint-disable camelcase */
 
-/** The result of a call to CryptoApi.exportRoomKeys */
+/** The result of a call to {@link crypto-api!CryptoApi.exportRoomKeys} */
 export interface IMegolmSessionData extends Extensible {
     /** Sender's Curve25519 device key */
     sender_key: string;
diff --git a/src/crypto-api/index.ts b/src/crypto-api/index.ts
index 30d075b69f..4f87bc242f 100644
--- a/src/crypto-api/index.ts
+++ b/src/crypto-api/index.ts
@@ -584,7 +584,7 @@ export interface CryptoApi {
     /**
      * Determine if a key backup can be trusted.
      *
-     * @param info - key backup info.
+     * @param info - key backup info dict from {@link CryptoApi.getKeyBackupInfo}.
      */
     isKeyBackupTrusted(info: KeyBackupInfo): Promise<BackupTrustInfo>;
 
diff --git a/src/models/device.ts b/src/models/device.ts
index 358b88a066..5716f3e1fb 100644
--- a/src/models/device.ts
+++ b/src/models/device.ts
@@ -27,7 +27,7 @@ export type DeviceMap = Map<string, Map<string, Device>>;
 type DeviceParameters = Pick<Device, "deviceId" | "userId" | "algorithms" | "keys"> & Partial<Device>;
 
 /**
- *  Information on a user's device, as returned by CryptoApi.getUserDeviceInfo.
+ *  Information on a user's device, as returned by {@link crypto-api!CryptoApi.getUserDeviceInfo}.
  */
 export class Device {
     /** id of the device */
diff --git a/src/models/event.ts b/src/models/event.ts
index 57f6539f12..49c166a0f2 100644
--- a/src/models/event.ts
+++ b/src/models/event.ts
@@ -1079,7 +1079,7 @@ export class MatrixEvent extends TypedEventEmitter<MatrixEventEmittedEvents, Mat
      * signing the public curve25519 key with the ed25519 key.
      *
      * In general, applications should not use this method directly, but should
-     * instead use CryptoApi#getEncryptionInfoForEvent.
+     * instead use {@link crypto-api!CryptoApi#getEncryptionInfoForEvent}.
      */
     public getClaimedEd25519Key(): string | null {
         return this.claimedEd25519Key;