Issue #3451136 by quietone, gapple, ghost of drupal past: Improve documentation of AttachmentsInterface methods (cherry picked from commit d820d8ed)