adds comments for base model
updates comments and docblocks for clarity