diff --git a/core/src/main/java/hudson/model/View.java b/core/src/main/java/hudson/model/View.java
index e84529912c..5fcc85db28 100644
--- a/core/src/main/java/hudson/model/View.java
+++ b/core/src/main/java/hudson/model/View.java
@@ -40,10 +40,14 @@ import java.util.Map;
*
Note for implementors
*
* -
- * {@link View} subtypes need
+ * {@link View} subtypes need the newViewDetail.jelly page,
+ * which is included in the "new view" page. This page should have some
+ * description of what the view is about.
*
*
* @author Kohsuke Kawaguchi
+ * @see ViewDescriptor
+ * @see ViewGroup
*/
@ExportedBean
public abstract class View extends AbstractModelObject implements AccessControlled, Describable, ExtensionPoint {
diff --git a/core/src/main/java/hudson/model/ViewDescriptor.java b/core/src/main/java/hudson/model/ViewDescriptor.java
index 623001aad7..07a8201aa4 100644
--- a/core/src/main/java/hudson/model/ViewDescriptor.java
+++ b/core/src/main/java/hudson/model/ViewDescriptor.java
@@ -4,6 +4,7 @@ package hudson.model;
* {@link Descriptor} for {@link View}.
*
* @author Kohsuke Kawaguchi
+ * @since 1.269
* @see View#LIST
*/
public abstract class ViewDescriptor extends Descriptor {