more detailed method documentation