Comments in configuration files

[Rahul Sundaram <sundaram redhat com>]

Hi

It seems that several configuration files in Fedora does not include 
helpful comments as necessary to guide users on where to look for 
information or which formats to follow.  The crontab files could have a 
initial commented line specifying the format or hosts file could refer 
people to its man page for examples. Would the documentation team be 
willing to file bug reports with comments/content as appropriate?

Do we need such guidelines as inclusion/release criteria?