improved comments and internal (private) method names