RE: An interview question

Subject: RE: An interview question
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: phil stokes <philstokes03 -at- googlemail -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 29 Mar 2013 08:21:16 -0700

phil stokes 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.

In the context of programming, "documentation" refers to documentation of the code, e.g., code comments, unit tests, maybe other software development artifacts. Reusability of code has nothing to do with end user documents.

Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-903-6372
------






^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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: An interview question
Next by Author: RE: Editing/Writing Test
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