Understand & document web-components more holistically

Comments like [this one by gampleman](https://discourse.elm-lang.org/t/improved-documentation-for-flags-ports-and-custom-elements/5552/5) outline some issues we might want to consider.