few documentation edits and checked that #32 is fixed