docs: add example docs for @validate and @validate_async_generator

docs: add example docs for @validate and @validate_async_generator #2001