VID-1968 Clean up getEmbed part of videoHandler interface

Good point. I meant to document this similar to https://github.com/Wikia/app/pull/4654/files#diff-1dd76b033a519415917195c532886578R93