shared_widget: Some documentation, add shorter constructor

The shorter constructor enables us to specify some options without needing to
specify the default values of multiplier which wasn't always appropriate and
could be confusing.