diff --git a/docs/deployment/application-deployment.md b/docs/deployment/application-deployment.md
index c0054ada8..bcad98b44 100644
--- a/docs/deployment/application-deployment.md
+++ b/docs/deployment/application-deployment.md
@@ -59,10 +59,9 @@ git remote add dokku dokku@dokku.me:ruby-rails-sample
 git push dokku master
 ```
 
-> Please note that the string `dokku@dokku.me:ruby-rails-sample` here is not a URL.
-> It is [a scp-like syntax supported in Git](https://git-scm.com/docs/git-clone#_git_urls_a_id_urls_a).
-> You may want to replace it with the full URL `ssh://dokku@dokku.me/ruby-rails-sample` in practice.
-
+> Note: Some tools may not support the short-upstream syntax referenced above, and you may need to prefix
+> the upstream with the scheme `ssh://` like so: `ssh://dokku@dokku.me/ruby-rails-sample`
+> Please see the [Git](https://git-scm.com/docs/git-clone#_git_urls_a_id_urls_a) documentation for more details.
 
 ```
 Counting objects: 231, done.