Fixed widget docs

Just doing some cleanup and making the docs consistent.
@NikV Can you add @return & @since too please. it's OK to use @since unknown