Although I don’t know how to program, I’ve seen some scripts and I know it’s possible to insert comments. In Gdevelop we also insert comments in the events, but the variables are organized in separate panels and so inserting information about them is not as simple as in the scripts.
We could insert comments on the events when the variables are used, but the explanations would be separated into several different events being harder to find when we want the information. We can make just one comment and write all variables, but we need do this to every variable and don’t forget when add a newone (a lot of work).
We can have a separate file to annotate, but is not as practical and powerful as having everything inserted into the project itself.
So I thought the most practical way to get information about the variables would obviously be within the variables panel itself. I thought of something like having a button to show/hide comments. Something like this:
My idea was to have a comment for each variable. Therefore, when the variable was chosen, your comment would appear if the box is visible.
I believe some will say that there is no need for comments for the variables. I disagree. I know that we must choose the names of the variables that represent their functions, but as the project grows or even when we need to stop the project for a while, comments with guidance are great help! And having this help in an easy and practical way would be even better!