Some refactoring after github code review

 * Exception throwing is now documented
 * Summary properties are now returned as refs