added xml comments to methods and classes