update docu, added xml comments for model