diff --git a/docs/modules/user-guide/partials/proc_troubleshooting.adoc b/docs/modules/user-guide/partials/proc_troubleshooting.adoc
index 6401dd74..864a7d03 100644
--- a/docs/modules/user-guide/partials/proc_troubleshooting.adoc
+++ b/docs/modules/user-guide/partials/proc_troubleshooting.adoc
@@ -23,3 +23,5 @@ NOTE: link:https://quay.io/repository/devfile/universal-developer-image[Universa
 Conversion fails with `Error processing devfile: failed to merge DevWorkspace volumes: duplicate volume found in devfile: volume_name`:: This means there are multiple volumes defined in the original devfile with the same name. Remove the duplicate volumes and proceed with the conversion.
 
 Conversion fails with `Error provisioning storage: Could not rewrite container volume mounts: volume component 'volume_name' is defined multiple times`:: This means the volume defined in the original devfile conflicts with a `volumeMount` propagated by an editor or a plug-in. Rename the volume in the devfile to be the same as the name of the `volumeMount` it conflicts with, and proceed with the conversion.
+
+Conversion fails with `Unable to resolve theia plugins: ms-vscode/node-debug2/latest is a mandatory plug-in but definition is not found on the plug-in registry. Aborting !`:: This means the deprecated `ms-vscode/node-debug2/latest` plug-in is included in the original devfile, but the newer plug-in registry includes the updated plug-in `ms-vscode/js-debug/latest`. Replace `ms-vscode/node-debug2/latest` with `ms-vscode/js-debug/latest` in the devfile to allow conversion to proceed.