au3WebDriver icon indicating copy to clipboard operation
au3WebDriver copied to clipboard

Standardize method of documenting errors in function headers

Open Danp2 opened this issue 1 year ago • 3 comments

See prior discussion in https://github.com/Danp2/au3WebDriver/issues/444

Danp2 avatar Apr 21 '23 21:04 Danp2

Prior discussion was not closed. So what this new ISSUE is intended to do in a different way than prior discussion ?

mlipok avatar Apr 25 '23 10:04 mlipok

I never indicated that it was closed. I simply referenced it for the value it already contains. If you read the prior discussion, then it should be clear why I opened this separate PR. Let me know if you still don't understand, and I will explain further.

Danp2 avatar Apr 25 '23 11:04 Danp2

Some related discussions --

https://github.com/Danp2/au3WebDriver/issues/444#issuecomment-1478234688

https://github.com/Danp2/au3WebDriver/issues/437

Also, this is from the wiki --

Return values

Details what is returned by the function. This often comes in the form of Success and Failure values, but this is not always the case. Any setting of the @error of @extended flags should be detailed, along with their meanings, in some cases it is enough to say that @error is set to non-zero in the event of an error, in most cases though a list of values for @error should be given.

Danp2 avatar Apr 30 '23 16:04 Danp2