One of the marks of a truly great WordPress developer, is his ability to include excellent commenting in his code. Go ahead, take a look at some of the plugins/themes by the best developers, and see how easy it is to read through their code. They adhere to the WordPress Coding Standards when writing HTML and PHP. There is also the CSS Coding Standards page on the Core Contributor Handbook, which is definitely another page to check out.
Today we will therefore look at the subject of commenting. I’m going to show you a few examples from top plugins and themes. We’ll be focusing on the use of commenting in the documentation of files and functions/classes, but we’ll also mention the normal comments you can sprinkle throughout your code.