Improved documentation of certain methods