Annotate model classes

Adds @phpdoc stuff & improves some comments

Change-Id: I8039ea0903cc86245252a72398a737125feb2ce9