[wp-trac] [WordPress Trac] #28388: Optional $post and $post_id should be documented as such

[WordPress Trac]

#28388: Optional $post and $post_id should be documented as such
--------------------------+-----------------
 Reporter:  DrewAPicture  |      Owner:
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  4.0
Component:  General       |    Version:
 Severity:  normal        |   Keywords:
  Focuses:  docs          |
--------------------------+-----------------
 In [25567] some usage of `$post_id` and/or `$post` were un-marked as
 optional as they rely on the post global.

 These (and others in core) need to be marked as optional, also notating
 that they default to the post global via `get_post()` where applicable.

 Related-ish: #20495

--
Ticket URL: <https://core.trac.wordpress.org/ticket/28388>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform