One page per task, for the jobs that take more than one call: the requests in order, the in-guest work between them, and what goes wrong in the middle.
Facts — limits, field names, error codes — belong to the guide that owns the resource, and a page here links rather than repeats.
Every page exists twice, the markdown and an .html twin. Fetch the markdown
and read it whole rather than through a summarizing fetch: a summary drops the
step you were missing.