Clarify webhook section and inform about manual updates

Author: naderman

troubleshooting.md

@@ -9,14 +9,17 @@ The amount of time between pushing a new version and seeing it on Private Packag
 
 New or updated versions for packages which are mirrored from packagist.org appear within seconds after the versions are available on packagist.org. The time between pushing to the VCS repository of packagist.org package and a change appearing on Private Packagist depends on whether the package has a working webhook set up on packagist.org and on how long it takes for GitHub/GitLab/Bitbucket to notify packagist.org about the change.
 
-##### Packages added to Private Packagist by URL either with a credential or via synchronization
+##### Packages with webhooks
 
-If you add a package by URL or through synchronization from GitHub, GitLab, or Bitbucket, we attempt to set up a webhook on the repository. This only works if you use synchronization or if you specified credentials to access the API along with the URL. We cannot set up webhooks for public packages without credentials to access their settings through the API.
-A successfully set up webhook means that new versions will appear within seconds or a few minutes after you push to the Git repository.
+If you add a package by URL or through synchronization from GitHub, GitLab, or Bitbucket, we set up a webhook on the repository to notify us about any changes. This only works if you use synchronization or if you specified credentials to access the API along with the URL. We cannot set up webhooks for public packages without credentials to access their settings through the API.
+
+For packages where we cannot automatically set up a webhook through an API we display a URL on the package page you can use to set up a webhook yourself. Many other code hosting platforms offer webhooks, you can trigger a POST request in a script of your own, or you can manually set up a webhook in a GitHub, GitLab or Bitbucket repository if you only grant us access to the code through SSH.
+
+With a webhook new versions will appear within seconds or a few minutes after you push to your Git repository.
 
 ##### All other packages
 
-For all other packages Private Packagist does not get notified about new versions and Private Packagist checks for updates at least once every 12 hours. Thus, new versions of these other packages will appear on Private Packagist with a delay of up to 12 hours.
+For all other packages Private Packagist does not get notified about new versions and Private Packagist checks for updates at least once every 12 hours. Thus, new versions of these other packages will appear on Private Packagist with a delay of up to 12 hours. You can manually update a package at any time by clicking the update button on the package page or using our API.
 
 Other packages include:
 - VCS repositories to which we have been granted access via SSH key