Component Props = Function arguments

[stargazer33]

I almost broke my head reading this section:
https://docs.astro.build/en/basics/astro-components/#component-props

What are actually these "props" ?

And then I realized a simple thing:

Defining props in .astro file -> we defining arguments.
When we render the component with some props: we are not "passing these props as attributes". We passing actual arguments.

OK, sometimes instead of "arguments" they say "parameters".
"Props" is quite a strange and unusual name. Anyway just explain in documentation:

"these props are actually component arguments, just like function arguments".

This will make documentation much more clear!

[louisescher]

An interesting thing to consider here is that a surprising amount of people expect Astro components to work like React JSX components, where they can call them as a function. If we say "Props are like function arguments" that might lead to more confusion among those people.
Just adding a support patrol members' perspective here based on what I've seen!

[stargazer33]

... expect Astro components to work like React JSX components, where they can call them as a function...

Probably I have to say that my background is backend programming with things like C, Java, a bit of Python.
"Big JS Frameworks" - always avoided like the plague )))

"React JSX components" -- no idea about this thing

...but props ARE like function arguments - what else could it be?

[stargazer33]

This can be explained roughly this way:

for people with background in procedural languages ( C, Python, Java) - props are like function arguments
for people with background in React - ...