update documentation and compatibility information