It's suitable to have static comments. The goal is to create expressions that will generate well-formed code suitable for pasting into the body of software projects.

Yes, the key concern is to annotate both the expressions and the generated code. In my opinion, it would be wise for Maplesoft to include a natural comment mechanism in their script language. Sure, the text is parsed, translated, and potential comments discarded; however, to the generated "C" code, the notation would provide real value to a technology (i.e., "C" code) that's part of our core competency as it is to many others. Also, imagine the benefit of having the widely used # comment capability throughout the expressions. No doubt it would be used extensively.