There is an issue regarding variable namings in the tutorials and pedagogy #3559
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Imagining you are a new programmer, the ruby tutorial on the website does not do as clear as could be in regards to calling the name input for the method called "name" when this may be unclear to new programmers who may be unclear about notion "method name". this lack of clarity can be solved by calling the input variable "text" which becomes clearer than the tutorial is as now.
For instance:
irb(main):019:0> def hi(name = "World")
irb(main):020:1> puts "Hello #{name.capitalize}!"
irb(main):021:1> end
hi is the "method name". While experience programmers know this it is the method name and "name" refers to the variable someone may not know this"
Let me know if you'd like this edit translated into the other languages and I can do this too. I can also go back and change it to "textVar" or "inputTxt".
I am also willing to rewrite tutorial to include this kind of basic programming info or create a tutorial thats more aimed at new programmers. It'd be better if I got info from the more active devs on this project if this is even going to be accepted as a commit so I can know if this is even worthwhile edit.