Tidy up the reference fields and comments

- use getReference* methods for ID based lookup
- Reference.description -> name to match the parent field and comment
- some small comment tweaks