added some docuemtentation to methods