The application life-cycle and threading model needs to be better documented in the javafx.application package, and specifically the Application class. We should provide links to this documentation from javafx.scene and javafx.stage classes such as Stage, Scene, and Node.