For a tiny SaaS API, I would rather document one ugly edge case than add three shiny examples that never fail.