Where is an API of, let’s say, one method: “DoSomething()”. There should be two versions of the method: asynchronous and synchronous. We should encourage API users to use async one so sync one probably should get more complicated and explicit name. So the problem is: how should we name this pair. To the date we’ve came up with:

  • DoSomethingAndWaitForResult() / DoSomething()
  • DoSomething() / DoSomethingAsync()
  • DoSomethingSync() / DoSomething()
  • DoSomething() / RequestSomething()

None of above schemes seems like optimal for us. Any suggestion folks?

Update. BTW do not hesitate to post one of the above as an answer if it fit you.

api-design
Edit
Report