I would recommend to write something about #98 (Java_Opts) and #120 (Better upstart script) for handling running instances in Debian.

* Java_Opts will get a better support ( #98 ) 
* Example for play with Java_Opts ( #120 ) -> [Play PID file](http://www.playframework.com/documentation/2.2.x/ProductionConfiguration) with `-Dpidfile.path=/var/run`