check for nil
cleanup documentation formatting from old style and update