Of course, if you use Html, LaTeX, APT or Java/C/C++ files, you should put diagram descriptions into comments.
By default, .png file have the same name as the source file used to generated them (only the extension changes). An automatic sequence is added if a source file contains several instances of @startXXX. It is possible to use a different file name for the generated file. For example: