continued inline documentation

better formatting along with the continued inline documentation