updated XML for docs - examples and descriptions