Click here to Skip to main content
15,891,033 members

The Insider News

   

The Insider News is for breaking IT and Software development news. Post your news, your alerts and your inside scoops. This is an IT news-only forum - all off-topic, non-news posts will be removed. If you wish to ask a programming question please post it here.

Get The Daily Insider direct to your mailbox every day. Subscribe now!

 
GeneralRe: Is there a correct way to comment your code? Pin
User 991608019-May-17 5:19
professionalUser 991608019-May-17 5:19 
GeneralRe: Is there a correct way to comment your code? Pin
Jon McKee18-May-17 23:14
professionalJon McKee18-May-17 23:14 
GeneralRe: Is there a correct way to comment your code? Pin
User 991608019-May-17 5:19
professionalUser 991608019-May-17 5:19 
GeneralRe: Is there a correct way to comment your code? Pin
Sander Rossel19-May-17 5:59
professionalSander Rossel19-May-17 5:59 
GeneralRe: Is there a correct way to comment your code? Pin
enhzflep22-May-17 16:43
enhzflep22-May-17 16:43 
GeneralRe: Is there a correct way to comment your code? Pin
Sander Rossel22-May-17 21:42
professionalSander Rossel22-May-17 21:42 
GeneralRe: Is there a correct way to comment your code? Pin
enhzflep23-May-17 18:27
enhzflep23-May-17 18:27 
GeneralRe: Is there a correct way to comment your code? Pin
Kevin McFarlane18-May-17 23:18
Kevin McFarlane18-May-17 23:18 
'On the subject of comments, programmers seem to fall roughly into two camps.  These include the “clean code needs no comments” camp and the “professionalism means commenting” camp.'

Both are true. 

'As a result, I offer the heuristic that the correct way to comment is to avoid them as much as humanly possible.'

And so is that.

'In addition you’ll want to add method header comments for the sake of documentation and Intellisense.  When you write code for consumption by others, these comments constitute de facto end user documentation.  In this situation, the value tends to outweigh the maintenance burden, since it impacts your product’s usability.'

I do this too but not comprehensively.
Kevin

GeneralRe: Is there a correct way to comment your code? Pin
Dan Neely19-May-17 2:56
Dan Neely19-May-17 2:56 
GeneralRe: Is there a correct way to comment your code? Pin
Kent Sharkey19-May-17 5:14
staffKent Sharkey19-May-17 5:14 
GeneralRe: Is there a correct way to comment your code? Pin
Dan Neely19-May-17 5:16
Dan Neely19-May-17 5:16 
NewsSinister implication of electronic toys Pin
Kent Sharkey18-May-17 7:14
staffKent Sharkey18-May-17 7:14 
GeneralRe: Sinister implication of electronic toys Pin
irneb18-May-17 22:07
irneb18-May-17 22:07 
NewsOver 560 million passwords discovered in anonymous online database Pin
Kent Sharkey17-May-17 15:49
staffKent Sharkey17-May-17 15:49 
GeneralRe: Over 560 million passwords discovered in anonymous online database Pin
SoMad17-May-17 18:56
professionalSoMad17-May-17 18:56 
GeneralRe: Over 560 million passwords discovered in anonymous online database Pin
Richard Deeming18-May-17 1:24
mveRichard Deeming18-May-17 1:24 
NewsMicrosoft removes Phone Call related APIs from Windows 10 Fall Creators Update Pin
Kent Sharkey17-May-17 11:42
staffKent Sharkey17-May-17 11:42 
GeneralRe: Microsoft removes Phone Call related APIs from Windows 10 Fall Creators Update Pin
Ron Anders17-May-17 12:09
Ron Anders17-May-17 12:09 
GeneralRe: Microsoft removes Phone Call related APIs from Windows 10 Fall Creators Update Pin
TheGreatAndPowerfulOz17-May-17 12:42
TheGreatAndPowerfulOz17-May-17 12:42 
NewsIBM just made a 17 Qubit quantum processor, its most powerful one yet Pin
Kent Sharkey17-May-17 11:32
staffKent Sharkey17-May-17 11:32 
GeneralRe: IBM just made a 17 Qubit quantum processor, its most powerful one yet Pin
Mario Vernari17-May-17 20:45
Mario Vernari17-May-17 20:45 
NewsYou can steal Windows login credentials via Google Chrome and SCF files Pin
Kent Sharkey17-May-17 10:21
staffKent Sharkey17-May-17 10:21 
GeneralRe: You can steal Windows login credentials via Google Chrome and SCF files Pin
Mark_Wallace17-May-17 21:35
Mark_Wallace17-May-17 21:35 
NewsUnder cyber attack: Researchers look at how to catch a 'phisher' Pin
Kent Sharkey17-May-17 10:00
staffKent Sharkey17-May-17 10:00 
GeneralRe: Under cyber attack: Researchers look at how to catch a 'phisher' Pin
PIEBALDconsult17-May-17 13:58
mvePIEBALDconsult17-May-17 13:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.