It would be great if queries, transformers and temporary states had an additional field/ tab in the editor for notes or description. This would allow people to document the purpose and any quirks of a query to make it easier for other people to work on the app.
In normal development I think most people would use code comments but due to the smaller "editor" areas in the Retool app I think this would be a good addition. Example layout below...
One step further would be a way to generate documentation for Retool apps, pulling from the proposed description/notes field, any parameters and outputs etc.