update caps doc with new caps and examples