update docs; add compatibility.md