Merge pull request #65 from jglick/JENKINS-32178-Javadoc

[JENKINS-32178] Noting why you should not override getUrlChildPrefix
jenkinsci · Jun 1, 2016 · 214079b · 214079b
2 parents 9987689 + 40f005e
commit 214079b
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/src/main/java/com/cloudbees/hudson/plugins/folder/AbstractFolder.java b/src/main/java/com/cloudbees/hudson/plugins/folder/AbstractFolder.java
@@ -324,6 +324,11 @@ public File getRootDirFor(I child) {
         return getRootDirFor(child.getName()); // TODO see comment regarding loadChildren and encoding
     }
 
+    /**
+     * It is unwise to override this, lest links to children from nondefault {@link View}s break.
+     * TODO remove this warning if and when JENKINS-35243 is fixed in the baseline.
+     * {@inheritDoc}
+     */
     @Override
     public String getUrlChildPrefix() {
         return "job";