update docs for markup changes