Add more details and references ot the compatability doc.