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

functions.xml Eliminate confusion in fn's parameters and arguments #4062

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

mmalferov
Copy link
Member

If we agree that a) parameters are part of the function signature, i.e. an integral part of the function declaration, and b) arguments are information that comes to the function from the outside, then we must eliminate confusion in the text. To simplify it: the arguments are passed, and the parameters take values from the arguments and, after argument's expression are evaluated, set values for their parameters. If so, there seem to be inconsistent places in the text where parameters are passed and functions take parameters rather than arguments or something like that

If we agree that a) parameters are part of the function signature, i.e. an integral part of the function declaration, and b) arguments are information that comes to the function from the outside, then we must eliminate confusion in the text. To simplify it: the arguments are passed, and the parameters take values from the arguments and, after argument's expression are evaluated, set values for their parameters. If so, there seem to be inconsistent places in the text where parameters are passed and functions take parameters rather than arguments or something like that
@Girgias
Copy link
Member

Girgias commented Nov 13, 2024

This whole section needs a rewrite and reorganisation as how we talk about functions currently is clunky AF.

@mmalferov
Copy link
Member Author

If the current proposal does not contain errors, can we at least accept them and make global changes later? I have already made changes to the Russian version and received criticism from colleagues for the fact that the translation text deviates from the original. But I can't leave the literal translation either, because the current original confuses the reader by calling arguments parameters and vice versa. I would like the function parameters to remain parameters, and the arguments that the function receives from the outside to remain arguments.

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

Successfully merging this pull request may close these issues.

2 participants