fixed failing doctest
periodic commit - updated a lot of doc strings
updated a lot more doc strings