Programmers Community

About importance of commenting of a code was spoken already many times. About importance of commenting of a code was spoken already many times.
If you would want that each class written by you was clear to you and your colleagues - can use the simple standard of record of the comments:

/ **
* Short description - used in indexlists
*
* Multiple line detailed description.
* The handling of line breaks and HTML is up to the renderer.
* Order: short description - detailed description - doc tags.
*
* @param string Target directory for the generated HTML Files
*/

If before the announcement of a class or method to write such comment - IDE will process it and will deduce to you the help at their further use. It is very convenient by collective development and large volumes of a code.
The purpose of methods becomes more clear, the transmitted parameters are deduced, the returned meanings are specified.
It is necessary to note that Eclipse automatically generates preparation under such style of the comment after introduction / ** and pressing Enter before the announcement of a method / class. And to receive the help it is possible on pressing Ctrl+Space after input $myClassName- >.

read comments (0)

When you create pages in ASP.NET - you must understand what you write. Comments help you write clean and clear code. Comments are the very important instrument of programmer. At the correct use of comments - his code is always clear a programmer and he can change him not reflecting.
Distinguish comments on the server-side and comments which are added to the outgoing HTML file.

If you want to write a comment which will be represented only inwardly aspx pages, and will not be visible an end user, use such syntax:
Read the rest of this entry »

read comments (0)