[focusgroup] Add mention and example for Shadow DOM behavior (#1010)
This change:
* Makes mention in various places that children/descendants are now "shadow-inclusive".
* Adds an example of a scenario where Shadow DOM children will participate in a focusgroup
* Adds this Shadow DOM behavior to the "Design decisions" section.
Fixes #521