document the URI resolution and connection processes better, enable keys to be bundled in the query string