add more method documentation