Welcome! As others have said, unfortunately the frustrations you ran into have been around for a long time. But the community is great!
As far as FAQs, I think Robin probably meant the following FAQ which explains the basic concepts for device, device type handler, and smart app:
But you might also find the following helpful:
1 Like