Docs: Document how to migrate from `Dial, DialContext, WithBlock, WithReturnConnectionError, FailOnNonTempDialError` to `NewClient`

[erezrokah]

Hello 👋

Related issues are #1786 and #7090 (the latter resolved via a release log note I believe).

Please close this issue if you think the above issues are sufficient to address the problem.

Based on the discussions in both issues having migration examples on how to move to NewClient seems like a good idea.

For example there are 2 patterns solving the same issue in #1786 (comment) and #1786 (comment). Which one is the recommended one?

Another issue is replacing grpc.WithBlock(), is it the same as using NewClient then calling Connect? What is the recommended way to connect and block without WithBlock?

If there are existing docs on doing the migration I missed could you point me to the right direction?

[purnesh42H]

@erezrokah thank you for your question. If not already done, you can refer to anti-patterns documentation which has more details on preference for NewClient over grpc.Dial.

Having said that, we are working on adding more documenation and examples for grpc.NewClient

[purnesh42H]

@erezrokah, #7248 has updated /examples and /documentation. Feel free to re-open the issue if anything else.

[erezrokah]

Thanks @purnesh42H I'll take a look 👍