javadoc on discard() CTR

Author: spmallette

gremlin-core/src/main/java/org/apache/tinkerpop/gremlin/process/traversal/Traversal.java

@@ -217,11 +217,10 @@ public default <A, B> Traversal<A, B> iterate() {
     }
 
     /**
-     * Filter all traversers in the traversal. This step has narrow use cases and is primarily intended for use as a
-     * signal to remote servers that {@link #iterate()} was called. While it may be directly used, it is often a sign
-     * that a traversal should be re-written in another form.
+     * Filter all traversers in the traversal. Formerly named {@code none()} prior to 3.8.0.
      *
-     * @return the updated traversal with respective {@link DiscardStep}.
+     * @see <a href="http://tinkerpop.apache.org/docs/${project.version}/reference/#discard-step" target="_blank">Reference Documentation - Discard Step</a>
+     * @since 3.8.0
      */
     public default Traversal<S, E> discard() {
         this.asAdmin().getBytecode().addStep(Symbols.discard);

gremlin-core/src/main/java/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.java

@@ -2044,11 +2044,10 @@ public default GraphTraversal<S, E> filter(final Traversal<?, ?> filterTraversal
     }
 
     /**
-     * Filter all traversers in the traversal. This step has narrow use cases and is primarily intended for use as a
-     * signal to remote servers that {@link #iterate()} was called. While it may be directly used, it is often a sign
-     * that a traversal should be re-written in another form.
+     * Filter all traversers in the traversal. Formerly named {@code none()} prior to 3.8.0.
      *
-     * @return the updated traversal with respective {@link DiscardStep}.
+     * @see <a href="http://tinkerpop.apache.org/docs/${project.version}/reference/#discard-step" target="_blank">Reference Documentation - Discard Step</a>
+     * @since 3.8.0
      */
     @Override
     default GraphTraversal<S, E> discard() {