bunch of doc changes; Issues #181 #182