API design

A compact guide to throws, Result, and typed domain errors.

Decode real-world payloads without turning models into a mess.

Use defer to keep cleanup logic honest and close to the scope it protects.

Design builder APIs that read clearly and stay predictable for callers.

Choose formatting APIs that are resilient to locale, context, and product change.

Organize targets and modules so package growth stays manageable.

Attach useful failure context without making calling code noisy.

Keep decoders resilient when APIs and persisted formats evolve over time.

Hide platform differences behind APIs that still feel clean to call.

Small naming decisions compound into whether an API feels obvious or tiring.