I am working on this Drupal 8 issue for documenting service tags. Right now it looks as though we may implement a @service_tag doc tag.

It would be good to match implementations if Symfony would want to document service tags. Has there been any interest among the Symfony developers in documenting service tags?