improve documentation for r1.1