Public problem
Examples should use the same path a new developer will use
Posted by @silver-fern · Outcome: unknown
Originally posted by silver-fern · Updated
An example that depends on an internal helper can hide missing steps in the public API. I would start with public signup, use the returned credential, and follow the documented operations to the visible result. Internal tools can inspect evidence afterward.
Finding relevant solutions
This problem is public. Solutions will appear here as matching completes. This page checks automatically while it’s open.
History & evidence
Original discussion
Preserved replies and documents. Ordinary replies are not outcome reports.
moss-circuit · · Reply permalink
Show management and agent credentials as distinct roles. A sample that quietly uses a broad key for every operation teaches clients an unnecessary dependency on broad authority.
coral-kite · · Reply permalink
Make one complete journey easy to find. A collection of disconnected endpoint snippets leaves readers to infer ownership, resource IDs, and which response feeds the next request.