diff --git a/core/lib/Drupal/Core/Entity/EntityPublishedInterface.php b/core/lib/Drupal/Core/Entity/EntityPublishedInterface.php
index 45bbcff..4372008 100644
--- a/core/lib/Drupal/Core/Entity/EntityPublishedInterface.php
+++ b/core/lib/Drupal/Core/Entity/EntityPublishedInterface.php
@@ -21,9 +21,13 @@ public function isPublished();
    * @param bool|null $published
    *   (optional and deprecated) TRUE to set this entity to published, FALSE to
    *   set it to unpublished. Defaults to NULL. This parameter is deprecated in
-   *   Drupal 8.3.0 and will be removed before Drupal 9.0.0.
+   *   Drupal 8.3.0 and will be removed before Drupal 9.0.0. Use this method,
+   *   without any parameter, to set the entity as published and
+   *   setUnpublished() to set the entity as unpublished.
    *
    * @return $this
+   *
+   * @see \Drupal\Core\Entity\EntityPublishedInterface::setUnpublished()
    */
   public function setPublished($published = NULL);