FYI; @BeardedConti posted this pros and cons video about ZHA versus Zigbee2MQTT for new users:
While it does not cover all caveats/ limitations in different scenarios, I think he does a great job at very quickly presenting a summarized comparison based on the current state of these two Zigbee gateway solutions for use with Home Assistant.
I do however think that it should be added that the development of these two projects (and the code components that they depend on) is moving relatively fast, so what is a fact on how they work today might have changed in a year from now, especially on the user-interface and end-user experience sides which become more and more mature in these projects.
Regardless, I highly recommend all Zigbee users read these to get a better general grasp on the caveats and limitations in common setups and different scenarios:
- Zigbee buyer's guide
- Zigbee networks: how to guide for avoiding interference and optimize for getting better range + coverage
*Migrating from a Philips Hue Bridge to the ZHA (Zigbee Home Automation) integration - Not many people know that... A random collection of Zigbee trivia
- A to Zig - a Zigbee glossary