added docs to readOptional and readNullableOptional
handle reading lists with nulls properly
fixed findInWithNulls