I find the documentation of components severely lacking in many places, especially on what options you have when setting them up. Attributes are sometimes but not always stated and the example yaml config does not always contain how you set up every attribute.
Yes, yes - I know there are example files out there but one should not need to google around for this (IMHO).
Many in the community are clever people who can figure out stuff on their own. But there are also many of us who need a helping hand. I see the same questions pop up over and over and over again and I don’t see why this need to be the case if the docs were better.