renamed method, added/improved documentation