hedy icon indicating copy to clipboard operation
hedy copied to clipboard

📜 Rename "commands" to "keywords" consistently where applicable

Open Felienne opened this issue 2 years ago • 5 comments

We use the words "commands" and "keywords" mixed in the code base and in the UI.

Just so we are clear: What I mean with both is: print, ask, if, where, etc. What you'd call keywords in any programming language.

I suspect the original logical was that for us developers keywords is clear, but for kids, it is not, so commands (commando's in Dutch) is clearer, but commands also shows up in the code base (see: https://github.com/search?q=repo%3Ahedyorg%2Fhedy%20commands&type=code)

So one cleanup it to rename commands to keywords in the codebase. Another question if whether "commands" is even the right word for kid-facing texts? Command is more "print hello"; a thing you say to the computer to command it, than a keyword like print alone.

But maybe we can leave that for now and at least clean up the code base a bit more.

Felienne avatar Oct 31 '23 20:10 Felienne

Hi!

I would like to take this on. I've heard about this project on CoRecursive and Filosofie in Actie podcasts, love the concept and want to contribute. Programming has been my job for years, but I've never contributed to open source before, and python is not my first language, so this seemed to me like a good place to start.

Koen

koenelsdijk avatar Jun 29 '25 16:06 koenelsdijk

Just noticed the attached PR. Will take a look at it. So far this issue is a nice way of introducing myself to the code base. Taking my (somewhat sparse) time to do so.

koenelsdijk avatar Jul 01 '25 15:07 koenelsdijk

Just noticed the attached PR. Will take a look at it. So far this issue is a nice way of introducing myself to the code base. Taking my (somewhat sparse) time to do so.

Hi Koen! Thanks for being excited about the project and this issue! I indeed did a half assed attempt, not sure whether it is going to be helpful to you. If not feel free to start anew!

And if you have questions, let us know here or in Discord!

Felienne avatar Jul 01 '25 18:07 Felienne

“Hi, I’d like to fix the naming inconsistency between commands and keywords in the codebase. Can I work on this?”

Jhanvi-code23 avatar Oct 22 '25 09:10 Jhanvi-code23

Hi Jhanvi, I meant to work on this more, but haven't really found/taken the time. 😅 The bit i did a few months ago seems pretty nastily conflicted with the main branch now, so I doubt if it could still be useful. Given life, work and other projects, I don't see me spending meaningful amounts of time on this soon, so I have no problem handing it over.

koenelsdijk avatar Oct 25 '25 20:10 koenelsdijk