diff --git a/router/java/src/net/i2p/router/package.html b/router/java/src/net/i2p/router/package.html
index e18dbdf96..dc610cc0c 100644
--- a/router/java/src/net/i2p/router/package.html
+++ b/router/java/src/net/i2p/router/package.html
@@ -10,6 +10,9 @@
 Classes in this package, sub-packages, and others in router.jar are
 not for use by apps, clients or plugins (except for routerconsole).
 Subject to change. Not necessarily maintained as a stable API.
+</p><p>
+For applications bundling the I2P router, instantiate Router and call runRouter(), or use Router.main() or RouterLaunch.
+Most public methods in Router are maintained as a stable I2P for those bundling the router.
 </p>
     </body>
 </html>