Forum OpenACS Improvement Proposals (TIPs): Re: TIP #54 (Proposed) Add an adp tag to handle documenting and commenting adp files.

That is one option. However, as I understand it, the best practices recommendations for the project are to not use <% %> and <tcl></tcl> in adp templates if at all possible.

Another option would be, as I mentioned in the proposal, to do something like:

<if 0>
# Here are some comments
# that will be stripped
# before the compiled template
# is sent to the user

Again, this works, but I think a more generalized commenting mechanism would be beneficial. If this is ultimately rejected by the OCT, your option is probably what I'll use instead.