Next-gen ruby libs! » github.com/dry-rb » website: https://dry-rb.org » forum: https://discourse.dry-rb.org
Hi, does someone have some good patterns for documenting input/output of operations from dry-transaction?
Atm I'm doing something like this:
# Creates adjustment for order
#
# @param [Hash] input input for operation
# @option input [Order] :order !!document this
# @option input [Adjustable] :adjustable !!document this
# @option input [Boolean] :included !!document this
#
# @return [Dry::Monads::Either::Right, Dry::Monads::Either::Left, #success?, #failure?, #value]
#
but i'm not sure if it's clear enough for users. What do you think?