• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: Efficiently getting characters
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Efficiently getting characters


  • Subject: Re: Efficiently getting characters
  • From: Bill Bumgarner <email@hidden>
  • Date: Wed, 3 May 2006 09:49:12 -0700

On May 3, 2006, at 9:31 AM, Nir Soffer wrote:
On 03/05/2006, at 18:44, Bill Bumgarner wrote:
The documentation is perfectly clear.
The documentation is clear and correct for those who want to subclass NSString - but for most developers who just want to use a string it is confusing.

Then we disagree. The NSString documentation -- the class documentation itself -- along with class cluster documentation is quite clear in regards to usage patterns.


Backing up for a second, It seems that many programmers are approaching development from a "I need to use this method, therefore the method's documentation should provide every clue as to the usage details". Questions are asked that can be easily answered if the developer takes a moment to pop up the stack a bit; the class documentation, the framework documentation and the conceptual guides all exist specifically so that the developer can fully understand the design patterns in the large.

And understanding said design patterns in the large is critical to being a successful client of any framework, library, or API that attempts to achieve some kind of consistent design pattern throughout.

I digress -- let me close this by restating something I have said many times in the past. Read and re-read the documentation surrounding the stuff you are trying to use. Do so with every new release of Mac OS X. Take an hour once a month to reread a conceptual guide or go explore some docs that you haven't read before. I have been doing exactly this for many, many, years and I have never felt that said hour is wasted; I have always learned something that has led to me eliminating unnecessary code or to solve a problem in a much better way.

b.bum

_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list      (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden


  • Follow-Ups:
    • Re: Efficiently getting characters
      • From: Ondra Cada <email@hidden>
References: 
 >Efficiently getting characters (From: John Nairn <email@hidden>)
 >Re: Efficiently getting characters (From: Douglas Davidson <email@hidden>)
 >Re: Efficiently getting characters (From: Nir Soffer <email@hidden>)
 >Re: Efficiently getting characters (From: Bill Bumgarner <email@hidden>)
 >Re: Efficiently getting characters (From: Nir Soffer <email@hidden>)

  • Prev by Date: Re: NSTableView question
  • Next by Date: Re: Efficiently getting characters
  • Previous by thread: Re: Efficiently getting characters
  • Next by thread: Re: Efficiently getting characters
  • Index(es):
    • Date
    • Thread