FROM : j o a r
DATE : Mon Jun 16 18:47:17 2008
On Jun 16, 2008, at 9:05 AM, Adam R. Maxwell wrote:
> This level of vagueness is persistent throughout the framework docs,
> though, and gives them an absolute value |v| < 0 with respect to
> threading (my opinion, of course). And yes, I know the "file a bug
> report" mantra, but a) I don't get paid for filing bug reports, and
> b) it can take years even for a doc bug to be fixed (my oldest is
> from 2005, but I expect it's just forgotten).
You're clearly right in that Apple needs to provide much better
documentation with regards to thread safety.
While I would also have to respect your "I'm not paid for filing bug
reports" standpoint, just keep in mind that bug reports does matter -
a lot - and I can assure you that it's much easier to get a feature
request on improved documentation fixed, than it is to get a feature
request on a software product fixed. The reason why this is the case
should be clear to anyone working in the software industry. For this
reason it is my experience that it's typically rather gratifying to
file doc bugs - give it another chance!
If you have a very old bug open for a simple documentation fix I'd
suggest that you contact ADC and ask for an update. There might be
some sort of misunderstanding:
<http://developer.apple.com/contact/>
j o a r
DATE : Mon Jun 16 18:47:17 2008
On Jun 16, 2008, at 9:05 AM, Adam R. Maxwell wrote:
> This level of vagueness is persistent throughout the framework docs,
> though, and gives them an absolute value |v| < 0 with respect to
> threading (my opinion, of course). And yes, I know the "file a bug
> report" mantra, but a) I don't get paid for filing bug reports, and
> b) it can take years even for a doc bug to be fixed (my oldest is
> from 2005, but I expect it's just forgotten).
You're clearly right in that Apple needs to provide much better
documentation with regards to thread safety.
While I would also have to respect your "I'm not paid for filing bug
reports" standpoint, just keep in mind that bug reports does matter -
a lot - and I can assure you that it's much easier to get a feature
request on improved documentation fixed, than it is to get a feature
request on a software product fixed. The reason why this is the case
should be clear to anyone working in the software industry. For this
reason it is my experience that it's typically rather gratifying to
file doc bugs - give it another chance!
If you have a very old bug open for a simple documentation fix I'd
suggest that you contact ADC and ask for an update. There might be
some sort of misunderstanding:
<http://developer.apple.com/contact/>
j o a r






Cocoa mail archive

