diff --git a/docs/cli/deploy.md b/docs/cli/deploy.md
index 84f532e1c44a..e53a4bfddeba 100644
--- a/docs/cli/deploy.md
+++ b/docs/cli/deploy.md
@@ -43,6 +43,21 @@ ENTRYPOINT ["node", "index.js"]
 
 ## Options
 
+### --force
+
+If the target directory that you deploy to is not empty, the deploy command will fail with error `ERR_PNPM_DEPLOY_DIR_NOT_EMPTY`.
+
+Use `--force` option to override this behavior and allow deploying to a non-empty directory.
+
+### --ignore-scripts
+
+`pnpm deploy` will call `pnpm install` behind the scenes to resolve dependencies,
+which in turn may trigger lifecycle scripts like `prepare`, `preinstall`, `postinstall`, etc.
+
+Use `--ignore-scripts` option to prevent running those scripts during deployment.
+
+Read more at [install --ignore-scripts](./install.md#--ignore-scripts).
+
 ### --dev, -D
 
 Only `devDependencies` are installed.
diff --git a/docs/cli/patch.md b/docs/cli/patch.md
index 29e49dd1b42d..fba95ec64b78 100644
--- a/docs/cli/patch.md
+++ b/docs/cli/patch.md
@@ -108,7 +108,7 @@ allowUnusedPatches: true
 
 ### ignorePatchFailures
 
-Added in: v10.7.0
+Added in: v10.7.0 (but will be removed in v11)
 
 * Default: **undefined**
 * Type: **Boolean**, **undefined**