Apply suggestions from code review

Co-authored-by: Adrian Görler <[email protected]>

java/developing-applications/running.md

@@ -82,5 +82,13 @@ If the Spring Boot Devtools configuration of your CAP Java application defines a
 
 ### Multitenant Applications
 
-With the streamlined MTX, you can run your multitenant application locally along with the MTX sidecar and use SQLite as the database. 
+With the streamlined MTX, you can run your multitenant application locally along with the MTX sidecar and use SQLite as the database.
 See [the _Multitenancy_ guide](../../guides/multitenancy/#test-locally) for more information.
+
+
+## Debugging
+
+You can debug both local and remote Java applications.
+
+- For local applications, it's best to start the application using the integrated debugger of your [preferred IDE](../../tools/cds-editors).
+- Especially for remote applications, we recommend [`cds debug`](../../tools/cds-cli#java-applications) to turn on debugging.

tools/cds-cli.md

@@ -551,7 +551,7 @@ There a couple of shortcuts and convenience functions:
 `cds debug` lets you debug applications running locally or remotely on Cloud Foundry.
 Local applications will be started in debug mode, while (already running) remote applications are put into debug mode.
 
-To debug a application on Cloud Foundry, make sure
+To debug an application on Cloud Foundry, make sure
 - to be logged in to the space where the application is deployed to,
 - that you have developer permissions in the space
 - that the app is running and [reachable through SSH](https://docs.cloudfoundry.org/devguide/deploy-apps/ssh-apps.html#check-ssh-permissions).
@@ -563,7 +563,7 @@ cf ssh-enabled <app-name>  # to check if SSH is enabled
 ```
 
 ::: tip Scale to one application instance only
-We recommend to only scale to _one_ app instance on SAP BTP Cloud Foundry, as then your request is guaranteed to hit this one instance.
+We recommend to only scale to a _single_ app instance on SAP BTP Cloud Foundry, as then your request is guaranteed to hit this one instance.
 If you scale out to more instances, only some of your requests will hit the instance that the debugger is connected to. This can result in 'missed breakpoints'.
 
 However, it's possible to [route a request to a specific instance](https://docs.cloudfoundry.org/devguide/deploy-apps/routes-domains.html#surgical-routing), which is useful if you can't reduce the number of app instances.