updated docs & examples