diff --git a/lib/types.ts b/lib/types.ts
index 32a32493b..1d1d1af54 100644
--- a/lib/types.ts
+++ b/lib/types.ts
@@ -94,6 +94,7 @@ export interface AppleDevice {
   udid: string;
   simctl?: any;
   devicectl?: any;
+  /** @deprecated We'll stop supporting idb */
   idb?: any;
   [key: string]: any;
 }
diff --git a/lib/webdriveragent.js b/lib/webdriveragent.js
index 09f3e10fd..9c045aad5 100644
--- a/lib/webdriveragent.js
+++ b/lib/webdriveragent.js
@@ -35,7 +35,7 @@ export class WebDriverAgent {
   agentPath;
 
   /**
-   * @param {import('appium-xcode').XcodeVersion} xcodeVersion
+   * @param {import('appium-xcode').XcodeVersion | undefined} xcodeVersion @deprecated Will be removed as no actual usage.
    * @param {import('./types').WebDriverAgentArgs} args
    * @param {import('@appium/types').AppiumLogger?} [log=null]
    */
@@ -51,6 +51,7 @@ export class WebDriverAgent {
     this.iosSdkVersion = args.iosSdkVersion;
     this.host = args.host;
     this.isRealDevice = !!args.realDevice;
+    /** @deprecated We'll stop supporting idb */
     this.idb = args.device.idb;
     this.wdaBundlePath = args.wdaBundlePath;
 
@@ -539,6 +540,7 @@ export class WebDriverAgent {
   }
 
   /**
+   * @deprecated We'll stop using idb
    * @returns {Promise<{wdaBundleId: string, testBundleId: string, wdaBundlePath: string}>}
    */
   async prepareWDA () {
diff --git a/lib/xcodebuild.js b/lib/xcodebuild.js
index 34f10dfe6..1cdfdd61b 100644
--- a/lib/xcodebuild.js
+++ b/lib/xcodebuild.js
@@ -46,7 +46,7 @@ export class XcodeBuild {
   xcodebuild;
 
   /**
-   * @param {import('appium-xcode').XcodeVersion} xcodeVersion
+   * @param {import('appium-xcode').XcodeVersion | undefined} xcodeVersion @deprecated Will be removed as no actual usage.
    * @param {import('./types').AppleDevice} device
    * @param {import('./types').XcodeBuildArgs} args
    * @param {import('@appium/types').AppiumLogger | null} [log=null]