15,890,506 members
Sign in
Sign in
Email
Password
Forgot your password?
Sign in with
home
articles
Browse Topics
>
Latest Articles
Top Articles
Posting/Update Guidelines
Article Help Forum
Submit an article or tip
Import GitHub Project
Import your Blog
quick answers
Q&A
Ask a Question
View Unanswered Questions
View All Questions
View C# questions
View C++ questions
View Javascript questions
View Visual Basic questions
View Python questions
discussions
forums
CodeProject.AI Server
All Message Boards...
Application Lifecycle
>
Running a Business
Sales / Marketing
Collaboration / Beta Testing
Work Issues
Design and Architecture
Artificial Intelligence
ASP.NET
JavaScript
Internet of Things
C / C++ / MFC
>
ATL / WTL / STL
Managed C++/CLI
C#
Free Tools
Objective-C and Swift
Database
Hardware & Devices
>
System Admin
Hosting and Servers
Java
Linux Programming
Python
.NET (Core and Framework)
Android
iOS
Mobile
WPF
Visual Basic
Web Development
Site Bugs / Suggestions
Spam and Abuse Watch
features
features
Competitions
News
The Insider Newsletter
The Daily Build Newsletter
Newsletter archive
Surveys
CodeProject Stuff
community
lounge
Who's Who
Most Valuable Professionals
The Lounge
The CodeProject Blog
Where I Am: Member Photos
The Insider News
The Weird & The Wonderful
help
?
What is 'CodeProject'?
General FAQ
Ask a Question
Bugs and Suggestions
Article Help Forum
About Us
Search within:
Articles
Quick Answers
Messages
Comments by kanalbrummer (Top 3 by date)
kanalbrummer
11-Jan-16 23:01pm
View
Reason for my vote of 5 \n Fine idea, thanks for sharing.
Added this article to my favorites!
kanalbrummer
16-Sep-13 8:54am
View
Reason for my vote of 5 \n Thanks for sharing.
Reading and viewing DXF files looks very interesting for me.
kanalbrummer
28-Aug-12 1:54am
View
Reason for my vote of 5
Fully agree.
In the age of intellisense, it is very easy to use longer and descriptive variable names.
If a constant needs to be commented, I write something like this // first shipment has this index
Having longer names eases renaming a variable with search-and-replace. Imagine you should rename a variable named i. It is much more easy to rename a variable named nShipment.
In contrast, functions should be commented well: Functionality, input params, return value and side effects (if any) etc. Sometimes you need to comment if an object should be deleted externally or if the object will be deleted within the function. Also index boundaries shall be commented (included boundary)