In designer use /* .. */ preceding or following the procedure. This is due to when validation is done, the result of the validation is returned without the comments within the procedure.
However, if you use a dynamic VDB to define the procedure. it can be defined within the syntax.
What are the comment syntax authorized in procedures ? I tried line comment "--" but it gives an error at SQL validation time in Teiid Designer.