--- a/org/jedit/package.html
+++ b/org/jedit/package.html
@@ -1 +1,4 @@
-<html><body>jEdit 5 API</body></html>
+<html><body>
+<h1>jEdit 5 API</h1>
+<p> New classes should go here instead of under <tt>org.gjt.sp</tt> packages. </p>
+</body></html>