Advertise Mobile SDKs Books Events Forum News Social Networking Support Us
Follow @iphonedevsdk on Twitter

Interface 2, Advanced iOS
Mockup & Code Gen
($9.99)

Make your own iPhone apps
and run them live!
(free)

Pic Frame Dynamo: Photo Editing
($0.99)

Abiliator
($1.99)

Want your application or service advertised on iPhone Dev SDK?

Go Back   iPhone Dev SDK Forum > Community Center > Off Topic

Reply
 
LinkBack Thread Tools Display Modes
Old 09-14-2011, 02:36 PM   #1 (permalink)
SOFTOFT TECHECH
 
Paul Slocum's Avatar
 
Join Date: Mar 2011
Location: Queens, NY
Posts: 262
Paul Slocum is on a distinguished road
Default iOS Code Commenting Culture

Coming from a non-Apple embedded programming background, I've noticed that in the Apple dev world it appears more acceptable to omit comments that explain what you're doing in your code. Although there are always coders around who are lazy about commenting, in the fields that I've worked in, professional code was usually well-commented and every job required good comments. But in the Apple world it seems like it's considered a little more acceptable, because I've found code from Apple and major vendors and many other places that is poorly commented, and some iPhone devs I've worked with don't comment, and they argue that there just isn't time to do it while meeting deadlines and therefore it's not a requirement.

Is the philosophy of omitting comments partly just that the code should be readable and that variable/function names should be chosen such that comments aren't needed? I've tried this, but for me personally it never works as well as including good comments. Maybe I'm just bad at reading code.

Or I'm wrong, and it's just that I've worked at places and in fields where they happen to comment a lot, and/or I happen to have been exposed to some atypical Apple code and devs who comment less than normal.
__________________
Paul Slocum is offline   Reply With Quote
Old 09-14-2011, 03:30 PM   #2 (permalink)
Knows SQL
 
iisword's Avatar
 
Join Date: Oct 2009
Location: Somewhere the streets are on fire, the sewers are flooded, and the cats are high on catnip
Posts: 529
iisword is on a distinguished road
Default

Personally I do comments, but not on a very large scale. I'm mostly solo, so unless I'm doing work for another company or I'm in a group, I'll only put very simple comments if I think I'll have to go back later.

Also I find the language to be much easier to read than others I've worked with.
__________________
iisword is offline   Reply With Quote
Old 09-15-2011, 05:11 PM   #3 (permalink)
Indie Developer
 
iSDK's Avatar
 
Join Date: Jul 2010
Posts: 1,346
iSDK is on a distinguished road
Send a message via AIM to iSDK
Default

Quote:
Originally Posted by iisword View Post
Also I find the language to be much easier to read than others I've worked with.
+1 To that.

I don't comment code as I have never needed to. If I come across a problem in the code, usually I will just comment what is going on, and return to it later on.

Thats pretty much the only time I do.
iSDK is online now   Reply With Quote
Reply

Bookmarks

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are On



» Advertisements
» Online Users: 467
20 members and 447 guests
7twenty7, beckz007, Bryan1, ChrisYates, coolman, David-T, Domele, iAppDeveloper, iSDK, jbro, Kieren Harrold, mer10, MysticLine, nadav@webtview.com, Raphael Rivas, revg, SLIC, solardrift, taylor202, usernametaken
Most users ever online was 1,387, 04-10-2012 at 04:21 AM.
» Stats
Members: 175,685
Threads: 94,132
Posts: 402,935
Top Poster: BrianSlick (7,990)
Welcome to our newest member, merlynpc45
Powered by vBadvanced CMPS v3.1.0

All times are GMT -5. The time now is 11:17 AM.
Powered by vBulletin® Version 3.8.0
Copyright ©2000 - 2012, Jelsoft Enterprises Ltd.
Search Engine Friendly URLs by vBSEO 3.3.0