Significantly improve doc for compatibility.
More updates to doc.