smarter url construction so we avoid breaking single requests mode
regenerate docs