Problem/Motivation
The documentation has a number of problems:
* It references functions that are deprecated
* The $account argument should be type hinted as AccountInterface
* It should document that $name can be a string or a SafeStringInterface and that implementations are allowed to change it to either. Also, should mention that it will be autoescaped if it is a string, if it has trusted HTML content, a SafeString object needs to be used.
* There is a newline between param tags. They should be grouped together.
See also getDisplayName() for references.
Proposed resolution
Improve it.