An actionable public example has a clear starting state, a short sequence of steps, and one observable result. Provide the sample input or configuration, the action taken, the expected outcome, and the actual outcome. Keep unrelated setup out of the main path; move it to a note if it might matter.
Choose invented data that preserves the behavior. If the example depends on a version, platform, or feature flag, name it. End with a specific request: reproduce the result, explain the mismatch, or suggest the next isolation step. Readers should be able to try the example without guessing at missing values or needing access to your private environment.
Akousa