[Feature] Improve documentation, document returned type for all methods

[dcaillibaud]

Documentation is really clear and well organized, but for some methods return type isn't mentionned, and it's sometimes difficult to know if the method is async or not, for example on https://playwright.dev/docs/api/class-browsercontext#browsercontextclearcookies (for others, return type isn't mentionned but a sample code allow guessing).

Thanks

[aslushnikov]

difficult to know if the method is async or not, for example on https://playwright.dev/docs/api/class-browsercontext#browsercontextclearcookies

@dcaillibaud That's a good point!

for others, return type isn't mentionned but a sample code allow guessing

Can you please give some examples? This looks like a bug.

[aslushnikov]

Ah, I found that https://playwright.dev/docs/api/class-browsercontext/#browsercontextclearcookies is actually doesn't have a return type at all. That's definitely a bug.

[dgozman]

This is now fixed for the @next, and future releases. See https://playwright.dev/docs/next/api/class-browsercontext#browsercontextclearcookies for example.