The documentation is currently geared in the middle. We have both less experienced users and developers in our community. This will be a never-ending fight. As long as Home Assistant hasn't reached its goals for 1.0, this will remain that way, unfortunately.    While we are growing towards an end-user product, we are still not at that level.