added documentation comments before each method