backwards compatibility

usually projects are responsible for solving compatibility issues regarding third-party libraries and software provided by this repo. we should simply document it!