The QML States page should be more clear about things like the default state, creating multiple changes in a State, mention StateGroup, etc. It could also be better structured and have more information in general - currently it looks to be centered around the main example, when it could have more detail in the overview.

Also the main example in the State element docs needs to be fixed - it refers to a different example with different property values.