Modify header so that warning is a comment, not a doc

The docstring appears in generated documentation and autocomplete, and
the warning isn't helpful in those contexts.

Author: mehaase

generator/generate.py

@@ -16,22 +16,19 @@
 logging.basicConfig(level=log_level)
 logger = logging.getLogger('generate')
 
-SHARED_HEADER = '''DO NOT EDIT THIS FILE
+SHARED_HEADER = '''# DO NOT EDIT THIS FILE!
+#
+# This file is generated from the CDP specification. If you need to make
+# changes, edit the generator and regenerate all of the modules.'''
 
-This file is generated from the CDP specification. If you need to make changes,
-edit the generator and regenerate all of the modules.'''
-
-INIT_HEADER = '''\'\'\'
-{}
-\'\'\'
+INIT_HEADER = '''{}
 
 '''.format(SHARED_HEADER)
 
-MODULE_HEADER = '''\'\'\'
-{}
+MODULE_HEADER = '''{}
 
-Domain: {{}}
-Experimental: {{}}
+\'\'\'
+CDP {{}} Domain{{}}
 \'\'\'
 
 from cdp.util import event_class, T_JSON_DICT
@@ -730,7 +727,8 @@ def from_json(cls, domain: dict):
 
     def generate_code(self) -> str:
         ''' Generate the Python module code for a given CDP domain. '''
-        code = MODULE_HEADER.format(self.domain, self.experimental)
+        exp = ' (experimental)' if self.experimental else ''
+        code = MODULE_HEADER.format(self.domain, exp)
         import_code = self.generate_imports()
         if import_code:
             code += import_code