docs(core): document changes to autoRefresh

[xavdid]

Documentation for #512. The app-wide skipThrowForStatus is intentionally not documented because I don't anticipate CLI devs using that - they can do it in middleware if they'd like.

Did some other cleaning while I was in there.

[eliangcs]

Looks good! I suggest we clarify on a paragraph.

In addition, I think we should also edit the v10 Breaking Change: Auth Refresh section, because it would look outdated when v12 is out. But that doesn't have to be in this PR. Your call.

[eliangcs]

I found this paragraph is bit confusing. I suggest we clarify:

Suggested change

	Since v10, we call `response.throwForStatus()` before we return a response. You can prevent this by setting `skipThrowForStatus` on the request or response object. You can do this in `afterResponse` middleware if the API uses a status code >= 400 that should not be treated as an error.
	Since v10, `z.request()` calls `response.throwForStatus()` before it returns a response. You can disable automatic error throwing by setting `skipThrowForStatus` on the request object:
	// Disable automatic error throwing on the request object
	const perform = async (z, bundle) => {
	const response = await z.request({
	url: '...',
	skipThrowForStatus: true
	});
	// Now you handle error response on your own.
	// The following is equivalent to response.throwForStatus().
	if (response.status >= 400) {
	throw new z.errors.ResponseError(response);
	}
	};
	You can also do it in `afterResponse` if the API uses a status code >= 400 that should not be treated as an error.
	// Don't throw an error when response status is 456
	const disableAutoErrorThrowing = (response, z) => {
	if (response.status === 456) {
	response.skipThrowForStatus = true;
	}
	return response;
	};
	const App = {
	// ...
	afterResponse: [disableAutoErrorThrowing],
	// ...
	};

[xavdid]

Ah, good call! So many sections.

I've gone ahead and pulled that whole section- it's not relevant in the 12.0 docs, but will live on in the older ones if we need it.