The API docs for the javafx.embed.swing package are misleading in that they only talk about the JFXPanel capability (embedding a JavaFX Scene in a Swing JComponent) and ignore the SwingNode functionality entirely. The module docs for the javafx.swing package correctly describe both directions of embedding and could provide a starting point for fixing the pacakge docs. In fact, just copying the module docs to the package docs would be better than what is there now.