Thanks for your patience while I dug into this @dsnvs.
I see what you mean with both of these examples here and we’re looking into making adjustments to our docs. I’ll follow up in this thread when I have more to share.
Regarding overall improvements to the documentation any types, a more complete reference and best practices guidance, that’s great feedback and I’ll make sure it’s heard. I understand where you’re coming from.
In the meantime, if you have any specific suggestions, or other examples of undocumented behaviour you’ve noticed, we would love to hear it!
Lastly, regarding the [BUG] LineItem.discount[].amount returns fixed amount for discount with percentage type thread you referenced, we’re looking into that as well and we’ll follow up in the thread as soon as we have more info.
I hope this helps and thanks again for bringing these examples to our attention!