Best practices

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.