start of TPS doc. minor method refactoring