updated docs with linked examples