documented methods and fixed bad written ones