clean up the docs, more httpifying them