Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use the same function name in the API of all languages #43

Open
zaikunzhang opened this issue May 1, 2024 · 0 comments
Open

Use the same function name in the API of all languages #43

zaikunzhang opened this issue May 1, 2024 · 0 comments

Comments

@zaikunzhang
Copy link

zaikunzhang commented May 1, 2024

I am decisively against using different function names in the API of different languages.

People are busy, lazy, and tired. Make things uniform to reduce people's mental burden. Don't do the opposite.

Call the main function benchmark, not run benchmark or its variants. The former is a verb that describes nicely what we do. It can also be a noun, but it means the reference/standard yiu compare with, not the action of comparison. Hence the latter does not make sense in English. It should be "run benchmarking". Check a dictionary.

benchmark should be the only function that you require a beginner to know in this package.
Otherwise, it is a failure of the design.

Keep things simple and stupid.

Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant