Combine developer documentation and user documentation

README.md

@@ -1,3 +1,22 @@
+# Jenkins Resource Disposer Plugin
+
+[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/resource-disposer.svg?color=blue)](https://plugins.jenkins.io/resource-disposer)
+[![Jenkins Plugin Installs](https://img.shields.io/jenkins/plugin/i/resource-disposer.svg?color=blue)](https://plugins.jenkins.io/resource-disposer)
+
+![](/docs/images/resource-disposer.png)
+
+Resource Disposer is a utility plugin for other plugins to depend on.
+Resources that are no longer needed (VMs to delete, entries in other
+systems, etc.) are registered in the plugin that attempts to delete it
+repeatedly. Failures to do so will be reported in the form of
+administrative monitor and can be examined at
+`JENKINS_URL/administrativeMonitor/AsyncResourceDisposer/`. Such entries
+are persisted between restarts and tracked until the plugin that has
+contributed them either succeeds in disposing them or they get removed
+some other way (ex: Administrator removes them manually). Provided the
+problem preventing the disposal persists, instance administrators are
+expected to resolve that based on administrative monitor reports.
+
 # Integrating Resource Disposer into plugin
 
 ## Overview
@@ -25,9 +44,3 @@ a way to report successful deletion in case the resource disappears.
 in a way to still be able to perform its task. In case the resource is freed by
 Jenkins restart naturally, it should deserialize into an object to report success
 all the time (to be unregistered on first periodic attempt to dispose).
-
-# Further Information
-See [user documentation and more](https://plugins.jenkins.io/resource-disposer/) on the Jenkins Plugin Site.
-
-[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/resource-disposer.svg?color=blue)](https://plugins.jenkins.io/resource-disposer)
-[![Jenkins Plugin Installs](https://img.shields.io/jenkins/plugin/i/resource-disposer.svg?color=blue)](https://plugins.jenkins.io/resource-disposer)