added return value documentation for my functions