diff --git a/core/src/main/java/hudson/tasks/BuildStep.java b/core/src/main/java/hudson/tasks/BuildStep.java
index 140de736761c2f97a61d59e4cc8883d304d365d6..14d3e05fa980e25c5a275ef11650a62d26c0ee2e 100644
--- a/core/src/main/java/hudson/tasks/BuildStep.java
+++ b/core/src/main/java/hudson/tasks/BuildStep.java
@@ -54,6 +54,10 @@ public interface BuildStep {
      * Returns an action object if this {@link BuildStep} has an action
      * to contribute to a {@link Project}.
      *
+     * <p>
+     * {@link Project} calls this method for every {@link BuildStep} that
+     * it owns when the rendering is requested.
+     *
      * @param project
      *      {@link Project} that owns this build step,
      *      since {@link BuildStep} object doesn't usually have this "parent" pointer.