Made this into a more general CDH info page. Put the migration scenarios at the bottom.

Completed-Download-Handling.md

@@ -1,4 +1,19 @@
-## Completed Download Handling vs Drone Factory
+**Completed Download Handling** is how Sonarr imports media from your download client to your series folders. It replaced an older system called the **Drone Factory** in early 2015. Most setups should exclusively use Completed Download Handling.
+
+#### How Completed Download Handling Works
+
+1. Sonarr will send a download request to your client, and associate it with a label or category name that you have configured in the download client settings. The default is 'tv'.
+2. Sonarr will monitor your download clients active downloads that use that category name. It monitors this via your download client's API. 
+3. When the download is completed, Sonarr will know the final file location as reported by your download client. This file location can be almost anywhere, as long as it is somewhere separate from your media folder. It also should not be the same as your Drone Factory folder, if you still use that system. Something like *C:\Downloads\Completed\TV* works well.
+4. Sonarr will scan that completed file location for video files. It will parse the video file name to match it to a show, season, and episode. If it can do that, it will rename the file according to your specifications, and move it to the TV Series folder.
+5. Leftover files from the download will be sent to your trash or recycling.
+
+If you download using a BitTorrent client, the process is slightly different:
+- Completed files are left in their original location to allow you to seed. When files are imported to your Series folder Sonarr will attempt to hardlink the file so that it is not using additional space on your disk. If the hardlink cannot be accomplished, Sonarr will copy the file and there will be two versions.
+- If the "Completed Download Handling - Remove" option is enabled in Sonarr's settings, Sonarr will delete the original file and torrent from your client, but **only** if the client reports that seeding is complete and torrent is stopped. 
+
+
+#### Completed Download Handling vs Drone Factory
 
 ##### Pros:
 
@@ -11,12 +26,12 @@
 ##### Cons:
 - Requires Sonarr and your download client to be on the same machine or the remote file system mounted locally and remapped in Sonarr with Remote Path Mapping.
 
-## Migration Scenarios
+#### Migrating to Completed Download Handling from Drone Factory
 
 Depending on your current configuration you may have to deal with one of the following scenarios.
 The health check link will attempt to direct you to the scenario specific for your configuration.
 
-#### Sabnzbd: Enable Completed Download Handling
+###### Sabnzbd: Enable Completed Download Handling
 
 Steps:
 
@@ -25,7 +40,7 @@ Steps:
 
 2. Once that's done you're ready to enable Completed Download Handling.
 
-#### Nzbget: Conflicting Download Client Category
+###### Nzbget: Conflicting Download Client Category
 
 _Your Download Client is configured to use a category which put completed downloads in the Drone Factory._
 
@@ -36,7 +51,7 @@ Steps:
 
 2. Once that's done you're ready to enable Completed Download Handling. 
 
-#### Nzbget: Enable Completed Download Handling
+###### Nzbget: Enable Completed Download Handling
 
 _Sonarr didn't detect any potential conflicts with your configuration. So you should be ready to enable Completed Download Handling._
 
@@ -44,7 +59,7 @@ Steps:
 
 1. Enable Completed Download Handling by toggling the switch on the Sonarr Settings -> Download Client page.  
 
-#### Unsupported: Download Client on Different Computer
+###### Unsupported: Download Client on Different Computer
 
 _As mentioned earlier, Completed Download Handling gets the file path to the download directly from the Download Client. Such a path is inaccessible from different computers and would prevent Completed Download Handling from importing the download._
 
@@ -52,7 +67,7 @@ The best solution to this problem is to run Sonarr and your Download Client on t
 
 _There are some advanced options to work around this limitation, but those will not be discussed here_
 
-## Keeping Completed Download Handling disabled
+##### Keeping Completed Download Handling disabled
 
 If you absolutely want to keep using the Drone Factory:
 
@@ -61,7 +76,7 @@ If you absolutely want to keep using the Drone Factory:
 
 This will permanently remove the warning.
 
-## Advanced Configuration/Migration Options
+##### Advanced Configuration/Migration Options
 
 The above scenarios were written to avoid complex choices. If you're a Power User you might want to have a couple of different options: