For now, we'll use this doc to capture things we decided against for the Design Guide.
Why not use "seconds since epoch" instead of RFC3339?
[2016 Mar 10] Seconds since epoch can be ambiguous, due to different definitions of epoch starting point and varying support for leap-seconds and other such nerd tomfoolery.
[2016 Mar 10] An interesting idea that may be feasible given the right infrastructure.
Heroku's API Design Guide states a preference for hyphens over underscores in URI paths, how about in ours?
[2016 Mar 10] While there is some support for this, particularly in public endpoints, our existing services already favor the underscore.
Since the point of a standard is consistency, and we're already consistent at this point, yada yada yada.
(**GET /offers/{offer_type}-{offer_id}.json
)