diff --git a/docs/generated/cli/workspace-lint.md b/docs/generated/cli/workspace-lint.md
index d119c1a14d6d7..c4f1ae20e7a37 100644
--- a/docs/generated/cli/workspace-lint.md
+++ b/docs/generated/cli/workspace-lint.md
@@ -5,7 +5,9 @@ description: 'Lint nx specific workspace files (nx.json, workspace.json)'
 
 # workspace-lint
 
-Lint nx specific workspace files (nx.json, workspace.json)
+    **Deprecated:** workspace-lint is deprecated, and will be removed in v17. The checks it used to perform are no longer relevant.
+
+    Lint nx specific workspace files (nx.json, workspace.json)
 
 ## Usage
 
diff --git a/docs/generated/packages/nx/documents/workspace-lint.md b/docs/generated/packages/nx/documents/workspace-lint.md
index d119c1a14d6d7..c4f1ae20e7a37 100644
--- a/docs/generated/packages/nx/documents/workspace-lint.md
+++ b/docs/generated/packages/nx/documents/workspace-lint.md
@@ -5,7 +5,9 @@ description: 'Lint nx specific workspace files (nx.json, workspace.json)'
 
 # workspace-lint
 
-Lint nx specific workspace files (nx.json, workspace.json)
+    **Deprecated:** workspace-lint is deprecated, and will be removed in v17. The checks it used to perform are no longer relevant.
+
+    Lint nx specific workspace files (nx.json, workspace.json)
 
 ## Usage
 
diff --git a/packages/nx/src/command-line/nx-commands.ts b/packages/nx/src/command-line/nx-commands.ts
index c2c1872ff69eb..2584106a70930 100644
--- a/packages/nx/src/command-line/nx-commands.ts
+++ b/packages/nx/src/command-line/nx-commands.ts
@@ -261,6 +261,8 @@ export const commandsObject = yargs
   .command({
     command: 'workspace-lint [files..]',
     describe: 'Lint nx specific workspace files (nx.json, workspace.json)',
+    deprecated:
+      'workspace-lint is deprecated, and will be removed in v17. The checks it used to perform are no longer relevant.',
     handler: async () => {
       await (await import('./lint')).workspaceLint();
       process.exit(0);