rewrite x and y documentation slightly