add more explanation for 1.1
update docs for 1.1