Ref management is confusing to use.

[awkay]

There are cases where ref management of to-one and to-many entities gets confused (depending on how you specify the form/query inclusions/etc. It is very hard to debug problems in such forms because we give no logging feedback about the problem, so you end up just using the transaction data to see that what is being sent is wrong, and then you have to diagnose what is constructed wrong in the UI.

This is complicated by the fact that the field subform section and field style affects how the system processes the refs in a way that is difficult to understand or guess at.

Some suggested improvements:

• [ ] More dev-time analysis and console error reporting
• [ ] Documentation on using refs via subforms for to-one and to-many
• [ ] Documentation on using refs via pickers for to-one and to-many