I agree with Ed, that a signature for the queries would be nice if some type of validation was performed. Nevertheless, as Dan described, the fundamental problem is that a query name will probably not give you all the information you want. This can be the case with any method, parameter, or class. The best solution may be just good software practice and thoroughly document the code. But this is one area where a good IDE could can be of great benefit. So while it may not be the best solution, another alternative may be to write an Emacs or Vi module so that with a keystroke, the query is looked up when the query name is highlighted/selected/active. This could be added to the file manager or SDM, and the documentation include a reference to it as a useful tool.
just my thoughts...
