added comments and docstrings and instructions when entering names