improving doc comments #4879

Job	Run time
check-proto-changes-python	1m 13s
docs (./packages/autogen-core)	1m 51s
docs-example-check (./packages/autogen-core)	3m 26s
format	2m 3s
lint	52s
markdown-code-lint	2m 37s
mypy (./packages/autogen-core)	3m 56s
mypy (./packages/agbench)	1m 9s
pyright (./packages/autogen-core)	1m 7s
samples-code-check	1m 30s
pyright (./packages/agbench)	56s
mypy (./packages/autogen-ext)	3m 24s
test (./packages/autogen-core)	1m 14s
pyright (./packages/autogen-ext)	1m 23s
mypy (./packages/autogen-agentchat)	1m 26s
pyright (./packages/autogen-agentchat)	1m 8s
test (./packages/autogen-ext)	4m 21s
mypy (./packages/magentic-one-cli)	1m 25s
test-grpc	1m 31s
pyright (./packages/magentic-one-cli)	1m 5s
test (./packages/autogen-agentchat)	1m 7s
codecov (./packages/autogen-core)	11s
codecov (./packages/autogen-ext)	9s
codecov (./packages/autogen-agentchat)	14s
codecov (autogen-ext-grpc)	12s
	39m 30s

Provide feedback