After I pointed out my diligent use of comments to Scott Lydiard,
President of aerial photography firm Verde Technologies, he advised me
not comment my code in any way.
WUT?
"That's because comments are rarely maintained in sync with the actual
source code."
For example:
int offset( void )
{
return 3; // return 4
}
This isn't the same as the jerks who think you're stupid if you can't
follow their logic. I regard it as my responsibility to make my
source clear and easy to maintain, even without comments.
However I am dead certain that it loses me work, when potential
clients look over my source and don't find any comments in it.
Mike
Michael David Crawford, Consulting Software Engineer
mdcrawf...@gmail.com
http://www.warplife.com/mdc/
Available for Software Development in the Portland, Oregon Metropolitan
Area.
On Tue, Jun 2, 2015 at 2:22 PM, Kyle Sluder <k...@ksluder.com> wrote:
> On Tue, Jun 2, 2015, at 03:42 PM, Charles Srstka wrote:
>> > On Jun 2, 2015, at 3:31 PM, Jens Alfke <j...@mooseyard.com> wrote:
>> >
>> > I agree, actually. But in Swift the concept of ivar no longer exists, so I
>> > have to rely on color/style to distinguish properties from locals.
>>
>> My solution with Swift is to consistently use the "self." prefix when
>> referencing properties. If Apple could include an optional compiler
>> warning to enforce this like they do with Obj-C auto-synthesis, it'd be
>> *great* (hint hint for any Apple engineers that happen to be reading
>> this).
>
> If you think this would be a worthwhile change to Swift, please file a
> Radar.
>
> --Kyle Sluder
>
> _______________________________________________
>
> Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)
>
> Please do not post admin requests or moderator comments to the list.
> Contact the moderators at cocoa-dev-admins(at)lists.apple.com
>
> Help/Unsubscribe/Update your Subscription:
> https://lists.apple.com/mailman/options/cocoa-dev/mdcrawford%40gmail.com
>
> This email sent to mdcrawf...@gmail.com
_______________________________________________
Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
https://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com
This email sent to arch...@mail-archive.com
