Jay > [snip] > I work in an organization where Web sites are developed by a team that > is > geographically distant. This increases the importance of commenting > code, > HTML, CSS, PHP. Does commenting cause a hit in the browser or on the > server? Specifically, does the browser or server need to > 'think' about > comments? > [/snip] > > Typically, no. Comments Are Good [TM] Comments can certainly be of benefit; a caveat being that since HTML comments are accessible to everyone, one should take care with the information that's included in source code. Information about the organisation, employee's names, file structures, system architecture etc. should be avoided. Example: If developers are distributed geographically then people on the other end of the phone are less likely to know them well. Consider this comment: <!-- The following added by Chris Marsh on 31/12/2005 --> This may be of use to other developers, but it's also excellent for engineers of the social persuasion. 1) Name: Chris Marsh 2) Job: Web developer 3) Date definitely employed at organisation: 31/12/2005 4) Nationality: Not US 5) Website worked on: www.example.com Regards Chris Marsh _______________________________________________________________________ This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the sender and delete the email immediately. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited. Please note that any views or opinions presented in this email are solely those of the author and do not necessarily represent those of the company. Finally, the recipient should check this email and any attachments for the presence of viruses. Callserve Communications accepts no liability for any damage caused by any virus transmitted by this email. _______________________________________________________________________ This email has been scanned for all viruses by the MessageLabs SkyScan service.