Is there any practical documentation on using the XDG Portals?

It seems like everything is "hints" that implementors may or may not implement with no identification of the implementation so that apps can somewhat handle it.

Just awful.

https://flatpak.github.io/xdg-desktop-portal/#gdbus-org.freedesktop.portal.FileChooser