documentation updates, examples of incompatibilities