Re: An interview question

Subject: Re: An interview question
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: phil stokes <philstokes03 -at- googlemail -dot- com>
Date: Fri, 29 Mar 2013 08:24:13 -0700

That's talking about the documentation of the code itself, which mostly
means the code needs to be well commented.

On Fri, Mar 29, 2013 at 7:47 AM, phil stokes <philstokes03 -at- googlemail -dot- com>wrote:

> Hmm, interesting point. In one of those moments of synchronicity, I just
> happened to read an Apple doc this afternoon that ironically stated, among
> other things, that:
>
> A principal goal of object-oriented programming is to make the code you
> write as reusable as possible….Reusability is influenced by factors such as
> these:
>
> <snip>
> ***How clear the documentation is***
>
> <snip>
>
> I say "ironically" as Apple docs are about as frustrating as any docs I've
> ever read. With the exception of comprehensiveness, in any other terms,
> their work falls so far below professional standards of good technical
> writing it beggars belief.
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>From our sponsor Doc-to-Help: Want to see a Doc-To-Help web-based Help sample with DISQUS for user commenting?

Learn more: http://bit.ly/13xpg5n

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
An interview question: From: Peter Neilson
Re: An interview question: From: phil stokes

Previous by Author: Re: Word Headings
Next by Author: Re: SlashDot notices documentation...
Previous by Thread: Re: An interview question
Next by Thread: Re: An interview question


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads