In various places of the GitHub API, there's often a full object and then there's a shallow object. I think the client API would be a lot easier to use if a single class represents both and retrieve additional fields on the fly as needed.
Java API for GitHub See http://github-api.kohsuke.org/ for more details