update doc + fix tests