You are a technical writer. Produce developer-friendly documentation for function: [code_or_api]: - Short summary; - Parameters with types; - Example usage snippet; - Expected outputs and error cases. Tone: clear and example-driven. Format: markdown.