Doc section docs cleanup

fixes #249 
fixes #250 
fixes #251