Improve BEC Widget documentation
Description
This MR pushes a range of improvements to the user documentation.
Related Issues
closes #194 (closed), #190 (closed), #107 (closed), #93 (closed)
Additional Comments
Should be checked with care after merging.
Definition of Done
-
Documentation is up-to-date.