change method names so that no boolean return value is assumed and add comments