Update documentation with compatibility notes (fixes #1)