update docs for new supported behavior