minor
[BUG #7710] improved widget API docs
[BUG #7831] get widget markup from samples
[BUG #7831] added widget samples