I would like to ask if developers would add notes in there LUA files to help us update them ( mainly those which have lists ) on how to update them. I have many add-ons that are not updated and no long longer maintained, and it's a pain to try to figure out how to update them.
Thanks.
It's nearly impossible @hagermanj to write the code in any way that it will be telling you where to change what, if the game API changes.
So Ayantir is right :
Clean code, comments and variable names that tell what they are used for help.
But you need to know the language and how it works, so you need to learn it at first.