another docs update, minor fix in comparison logic