close #28

Add comments in fields and methods of the candidate model