• 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: Documentation frustrations
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation frustrations


  • Subject: Re: Documentation frustrations
  • From: James Andrews <email@hidden>
  • Date: Sat, 9 Jul 2005 20:01:38 -0400


On Jul 9, 2005, at 6:18 PM, mmalcolm crawford wrote:
On Jul 9, 2005, at 1:59 PM, James Andrews wrote:
On Jul 9, 2005, at 4:52 PM, Charilaos Skiadas wrote:
My personal problem with this is that it never says that what it does is hide a window. The word hide is never used. Instead it says that it "takes the receiver out of the screen list". If I search in the documentation for the phrase "hide window", I would expect the right method to pop up. It doesn't.
I have to agree with this statement. I had no idea what this method did, until someone said something last night. I feel many of the methods could have a lot better descriptions. There are some that are obvious by their name, and don't need such documentation, but this is an example where the author could have chosen his/her words better.
So have you filed a bug?

Not yet, but I am going to. Cleaning the garage was today's priority. (~_^)


James

_______________________________________________
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


References: 
 >Re: Documentation frustrations (From: Raffael Cavallaro <email@hidden>)
 >Re: Documentation frustrations (From: mmalcolm crawford <email@hidden>)
 >Re: Documentation frustrations (From: Raffael Cavallaro <email@hidden>)
 >Re: Documentation frustrations (From: mmalcolm crawford <email@hidden>)
 >Re: Documentation frustrations (From: Raffael Cavallaro <email@hidden>)
 >Re: Documentation frustrations (From: mmalcolm crawford <email@hidden>)
 >Re: Documentation frustrations (From: James Andrews <email@hidden>)
 >Re: Documentation frustrations (From: Guy English <email@hidden>)
 >Re: Documentation frustrations (From: James Andrews <email@hidden>)
 >Re: Documentation frustrations (From: Scott Anguish <email@hidden>)
 >Re: Documentation frustrations (From: Dietmar Planitzer <email@hidden>)
 >Re: Documentation frustrations (From: Scott Anguish <email@hidden>)
 >Re: Documentation frustrations (From: Charilaos Skiadas <email@hidden>)
 >Re: Documentation frustrations (From: James Andrews <email@hidden>)

  • Prev by Date: Re: "untitled" vs "Untitled"
  • Next by Date: Re: NO future for Cocoa-Java ?
  • Previous by thread: Re: Documentation frustrations
  • Next by thread: Re: Documentation frustrations
  • Index(es):
    • Date
    • Thread