@@ -294,6 +294,31 @@ def self.try_strict_coerce(value)
294294 #
295295 # We can therefore convert string values to Symbols, but can't convert other
296296 # values safely.
297+ #
298+ # @example
299+ # ```ruby
300+ # # `billing_cycle_relative_date` is a `Orb::Models::BillingCycleRelativeDate`
301+ # case billing_cycle_relative_date
302+ # when Orb::Models::BillingCycleRelativeDate::START_OF_TERM
303+ # # ...
304+ # when Orb::Models::BillingCycleRelativeDate::END_OF_TERM
305+ # # ...
306+ # else
307+ # # ...
308+ # end
309+ # ```
310+ #
311+ # @example
312+ # ```ruby
313+ # case billing_cycle_relative_date
314+ # in :start_of_term
315+ # # ...
316+ # in :end_of_term
317+ # # ...
318+ # else
319+ # # ...
320+ # end
321+ # ```
297322 class Enum
298323 extend Orb ::Converter
299324
@@ -369,6 +394,56 @@ def self.try_strict_coerce(value)
369394 #
370395 # @abstract
371396 #
397+ # @example
398+ # ```ruby
399+ # # `discount` is a `Orb::Models::Discount`
400+ # case discount
401+ # when Orb::Models::PercentageDiscount
402+ # # ...
403+ # when Orb::Models::TrialDiscount
404+ # # ...
405+ # when Orb::Models::UsageDiscount
406+ # # ...
407+ # else
408+ # # ...
409+ # end
410+ # ```
411+ #
412+ # @example
413+ # ```ruby
414+ # case discount
415+ # in {
416+ # discount_type: :percentage,
417+ # applies_to_price_ids: applies_to_price_ids,
418+ # percentage_discount: percentage_discount,
419+ # reason: reason
420+ # }
421+ # # ...
422+ # in {
423+ # discount_type: :trial,
424+ # applies_to_price_ids: applies_to_price_ids,
425+ # reason: reason,
426+ # trial_amount_discount: trial_amount_discount
427+ # }
428+ # # ...
429+ # in {
430+ # discount_type: :usage,
431+ # applies_to_price_ids: applies_to_price_ids,
432+ # usage_discount: usage_discount,
433+ # reason: reason
434+ # }
435+ # # ...
436+ # in {
437+ # discount_type: :amount,
438+ # amount_discount: amount_discount,
439+ # applies_to_price_ids: applies_to_price_ids,
440+ # reason: reason
441+ # }
442+ # # ...
443+ # else
444+ # # ...
445+ # end
446+ # ```
372447 class Union
373448 extend Orb ::Converter
374449
@@ -839,6 +914,15 @@ def initialize(type_info, spec = {})
839914 #
840915 # @abstract
841916 #
917+ # @example
918+ # ```ruby
919+ # # `amount_discount` is a `Orb::Models::AmountDiscount`
920+ # amount_discount => {
921+ # amount_discount: amount_discount,
922+ # applies_to_price_ids: applies_to_price_ids,
923+ # discount_type: discount_type
924+ # }
925+ # ```
842926 class BaseModel
843927 extend Orb ::Converter
844928
0 commit comments