Apply suggestions from code review

Co-authored-by: Dan D'Avella <[email protected]>

src/codemodder/scripts/generate_docs.py

@@ -192,7 +192,7 @@ class DocMetadata:
     ),
     "remove-debug-breakpoint": DocMetadata(
         importance="Medium",
-        guidance_explained="Breakpoints are used for development debugging and can easily be forgotten before deploying code.",
+        guidance_explained="Breakpoints are generally used only for debugging and can easily be forgotten before deploying code.",
     ),
 }
 

src/core_codemods/docs/pixee_python_remove-debug-breakpoint.md

@@ -1,4 +1,6 @@
-This codemod removes any calls to `breakpoint()` or `pdb.set_trace()` which should only be used for active debugging and not in production code.
+This codemod removes any calls to `breakpoint()` or `pdb.set_trace()` which are generally only used for interactive debugging and should not be deployed in production code.
+
+In most cases if these calls are included in committed code, they were left there by mistake and indicate a potential problem.
 
 ```diff
  print("hello")