Add inline documentation and unit testing for `getDisplayName`

[dpikt]

Old docs can be found in legacy-docs.md. Remember to delete the relevant section once it's been added to the auto-generated docs.