doc improvement.

git-svn-id: https://hudson.dev.java.net/svn/hudson/trunk/hudson/main@3519 71c3de6d-444a-0410-be80-ed276b4c234a

core/src/main/java/hudson/model/SCMedItem.java

@@ -22,8 +22,9 @@ public interface SCMedItem extends BuildableItem {
      * {@link SCMedItem} needs to be an instance of
      * {@link AbstractProject}.
      *
-     * This method does {@code (AbstractProject)this} but emphasizes
-     * the fact that this cast must be doable.
+     * <p>
+     * This method must be always implemented as {@code (AbstractProject)this}, but
+     * defining this method emphasizes the fact that this cast must be doable.
      */
     AbstractProject<?,?> asProject();