updated doc based on recent changes with widget v2