if you're using Mako, you can use ## , which comments out the line.
that will never render and isn't automatically created on imports.
you could also use a build script - either with Fabfile or Ant ( like
the html5 blueprint build script )... have a source "folder" that is
your production , then run the build script to export it into
something developer friendly ( ie, remove ## from comment lines, wrap
include commands with comments, etc ). that would be rather easy,
except for template functions, though they could use explicit
commenting