added documenation strings to functions