I know we haven't done a great job of adding comments on our struct fields throughout the library (my own fault really), but this certainly seems like a case where some docs are needed.  Feel free to just copy verbatim from the GitHub API docs where appropriate.