updated documentation for all completed methods