commented methods and completed documentation