@mgorbach I think bigger picture/higher level documentation could help.
Currently everything is pretty well documented, but maybe the higher level vision and patterns are still hard to see.
AppIntents becomes more powerful if all participating apps are implemented using same ideas I think.
I always liked this:
https://dl.acm.org/doi/pdf/10.1145/141937.141943
Maybe the most strait forward way to provide this would be an official, comprehensive, and updated example app.
@mgorbach When implementing AppIntents I found this project by far the most useful resource: https://github.com/mralexhay/Booky
It's nice, but incomplete. More useful would be if Apple maintained a similar project and really exercised all the major features and expected patterns.
That would make AppIntent adoption much easier and I think really increase the quality of the average app implementation.