- Remove a param comment that duplicates information in the type
   definition
 - Add a note about a defensive null-check