The Sad State of Logging Bugs for Apple

Apple, Cocoa, Coding

You find a bug in macOS or iOS. Something in the software isn’t working the way it should work. You decide to let Apple know, and head over to http://bugreport.apple.com and login with your Apple ID. You fill out the required form, list the reproduction steps, hit the special key chord to generate a fat sysdiagnose, attach some screen shots, and hope they fix it. 

What happens to your bug?

All bugs are tracked with an internal application called Radar; internal Apple employees simply log bugs directly into this application. External people use the website “Bug Reporter”, which only shows specific developer interactions with the bug, and hide all other details of the bug. Those details are engineer comments, progress on the bug, when they “expect” to fix it or which build it is fixed in, and priority. Priority is important for bugs; they are considered “unscreened” if they don’t have a priority set. Bugs with a high priority (1) are highly likely to get fixed, whereas bugs with a lower priority (3 or 4) are not likely to ever get fixed.  

Each bug is placed into a particular top level component, which can have sub components. Savvy internal developers will log bugs directly into the component that the bug corresponds to, such as “AppKit / NSTableView”. This will get it directly to the right person who needs to look at it. Top level components have a large dropping areas that generic bugs can fall into, such as “iTunes / All”. These components get saturated with bug reports.

Once your bug hits Radar someone will look at it. Developer Support will often take a first look at bugs that are related to SDK/programming issues. They will then pass it on to a more specific top level component, or directly to a more specific component (ie: NSWindow).

This is where things get screwy depending on the component your bug lands in, since bug management is group dependent. Many groups will have only one or two QA people to do the initial screening of those large drop areas for bugs. QA engineers are sometimes instructed to screen bugs with a priority and “fix period” before passing them off to the engineer responsible for the code. This is terrible because many engineers will not look at bugs with a low priority. It is much better for the engineer who “owns the code” to look at a bug and determine the priority. The QA engineers will frequently get a huge back log of bugs to screen, and it can take weeks, or even months, for some bugs to get screened. Sometimes this leads to a mass screening of bugs, marking them all with a low priority. Bug originators have to notice this, and complain about it for the priority to get increased. Worse yet, some groups mass close bugs older than a year or so, and ask the originator to re-open the bug if the issue still exists. A lot of people don’t pay attention to bugs that need verification, and they simply become lost. 

From an internal developer’s perspective, it was quite frustrating to take the time to log a detailed bug, only to see it sit “unscreened” for weeks and weeks. It is demoralizing to see this happen to your bugs. But worse yet, sometimes your bug would get forward-duped. Someone else at a later time logs the same bug, and your older bug report gets duplicated to it. More often than not, this is simply because of the delayed screening of bugs.

From an external developer’s perspective, it is even worse. There is very little feedback on bugs when they are in progress. You don’t know what priority the bug has, or if it has even been looked at and screened. This is Apple intentionally being opaque. More transparency could easily leak features or products, so this is expected. 

Hopefully a bug ends up with an individual engineer who works on the code. A lot of these bugs will still be unscreened, and Apple engineers seem to loathe the process of screening bugs. So they let them sit around for a while, sometimes for weeks or months. People would rather focus on coding something new up, or working on already screened bugs that they have to fix, as opposed to taking the time to read a bug report and figure out what needs to be done with it. They don’t have to read it and fix it right then, but just do a screening: determine priority, when to fix it (this is sometimes nebulous), and possibly ask the originator for more information (or mark it as a duplicate.)

Engineers also dislike screening bugs because sometimes they have to add them to their queue for the current release. This increases their required workload for that release, which is something people don’t like doing. So, instead, many bugs stay unscreened.

Unscreened bugs indicate potential software problems that need to be fixed. Obviously this is bad, and management doesn’t like to have high unscreened bug counts. Managers will frequently instruct engineers to screen bugs, or ask QA engineers to do it (which is bad).

Sometimes QA screen bugs with a low priority and holds onto them. They never get moved to the appropriate code engineers, and effectively become lost in the system. Sadly, I had seen this happen way too often.

Bugs screened with a low priority and a nebulous-future fix date are also lost. They rarely will be revisited and fixed. Sometimes this is okay. Some bugs are just too obscure or rare to spend time fixing.

Some bug owners don’t want to take the time to go back and forth with the originator to find out some piece of information they may need. They sit on bugs for a long time, and eventually try to reproduce a bug on a later version of the un-released OS. They can’t reproduce it, so they just assume it is fixed, and send it back to the originator. This is particularly bad for external developers, and I’ll describe why below.

When a bug is sent back as fixed, the internal developer who originated the bug is supposed to verify the problem is resolved. They can send it back if the problem isn’t resolved. However, internal developers don’t really have an incentive to verify bugs. Management doesn’t keep track of bugs that need verification or really require developers to verify them. Most engineers do verify bugs; they like to make sure problems are resolved. But external developers are left in a more sad state. The bug becomes closed for them, and is dead. 

External developers do get notified when bugs are fixed, but only after the fix is available in a public release of the OS. This means it could take about a year for some bugs to get back to the external developer, since bugs start to get fixed *before* an OS is released to the public.  Generally, the bug will ask the external developer to verify the bug by installing the latest OS. For some people, including me, this just isn’t possible; they need to run and support an older OS, and don’t have the ability to install a newer OS on a particular machine. Or, they just won’t want to install the latest OS because it doesn’t have anything they want or need (that’s me, I run 10.13). Even if they do install the OS, they may find the bug isn’t fixed. At this point, it is simply too late; engineering has likely closed the bug, and it is lost in the ether.

What can Apple do? 

It is simple: Internal engineers need to take more responsibility in promptly screening bugs. Management needs to allow engineers to have more time to do this, which is at the expense of working on features or fixing already screened bugs. Engineers should always be expected to have a very low unscreened bug count. 

Internal engineers need to promptly verify bugs when they are sent back to them. They need to install beta versions of the OS and do some testing. If it isn’t fixed, send it back. 

If a bug report refers to some problem, then the developer should look at the code that interacts with the area described and try to think about what would cause such a problem to happen. For instance, if a button is incorrectly disabled in iTunes, then the developer should try to figure out why that could happen instead of just asking for “how to reproduce this?”

When I worked at Apple I practiced what I am now preaching. I would screen all my bugs within a day or so. I would verify bugs within a week or so. I would poke around at code and attempt to make theoretical fixes for bugs I couldn’t reproduce. I felt like it was part of my job, and I just did these things as a daily task. 

What can you do?

Obviously, you have to log bug reports. It’s okay to log bugs that are missing information; developers can ask for specifics of what they need. In general, for AppKit related bugs, I would find that a “sysdiagnose” rarely would provide any useful information. I would hate it when people (usually QA, and not the engineers who worked on the code) would ask me for a sysdiagnose, when I know it wouldn’t help them figure anything out.

Log duplicates. If you know someone else logged a bug, but you are encountering the same issue, then log the same bug. It will get marked as a duplicate, but this will help increase the priority of a bug. It is sad, but Apple does look at this, and bugs with “high dupe counts” are looked at. 

Previous Post
Making Perfect Inset Cabinets - DIY Kitchen Cabinets Ep 7
Next Post
Apple's iCloud Is Useless Due to Bugs

34
Leave a Reply

avatar
500
18 Comment threads
16 Thread replies
0 Followers
 
Most reacted comment
Hottest comment thread
15 Comment authors
c wPissedDeveloperRolandGStevFionn Recent comment authors
  Subscribe  
Notify of
trackback

[…] The Sad State of Logging Bugs for Apple 10 by fireflies_ | 1 comments on Hacker News. […]

trackback

[…] Source: http://www.corbinstreehouse.com […]

Radoslav Sharapanov
Guest
Radoslav Sharapanov

My “favourite” macOS bug is 14 years old and I have reported it countless times, including in email exchanges with Federighi. The OS doesn’t respect an app’s input language and changes it when switching apps. Default input, English, gets overwritten on app switch. There is an option, it doesn’t really work. This is my only serious problem with the macOS I love and it’s sad we get new bugs galore while old ones are ignored.

other
Guest
other

radar id?

RolandG
Guest
RolandG

Yeah that’s a funny one – imho I think it’s a feature but I see where you’re coming from

If I go to messages and switch to German, I like the fact that it goes back to English in Xcode. But maybe that’s just me?

I have keyboard shortcuts to switch between languages btw which I use all the time

Stephane
Guest
Stephane

I would add one very annoying sad thing about logging bugs at Apple and which is a consequence of different points you described:

Reported bugs are rarely fixed in minor OS updates. Waiting a year to get a simple bug fix is not reasonable and can make people stop using one’s application.

WIlliam Cerniuk
Guest
WIlliam Cerniuk

While there is very little to disagree with here, there is a rather large neon green elephant in the room that is not being addressed: It costs time to not only work around these defects in Apple products but it takes time to diagnose, document and report them. Time == Money.

Small companies can’t afford to have their engineers for free Apple for free as Apple’s QA Dept. We include an invoice with each bug report we file now to make the point.

Rory O’Kane
Guest

Another relevant part of logging bugs is the third-party site Open Radar (openradar dot me). When you submit a bug to Apple, if it doesn’t contain sensitive information, you can also post it to Open Radar. This can help other developers to understand relevant bugs, know their status, and intentionally file duplicates that reference a Radar number.

Diogene
Guest
Diogene

This is one of the top 3 reasons we move out of MacOS system on our company. The global sansation is an unsafe OS ecosystem.

trackback

[…] les bugs sont suivis avec une application interne appelée Radar », explique-t-il. « Les employés d’Apple se connectent simplement à cette application […]

Dad
Guest
Dad

Thanks for posting this. Explains what I’ve been experiencing on the outside. Curious if you saw any trends over the time you were there. Did things get worse over time? Or stay pretty much the same?

One thing that might help would be a way for devs to mark their bugs – or portions of their bugs (description and steps but not attachments, say) – as public. Would reduce total count to review & waste less dev time filing duplicates (could vote up or add to existing maybe).

cheers.

trackback

[…] Corbin Dunn (tweet, Hacker News): […]

Preston Sumner
Guest
Preston Sumner

The need for secrecy can be frustrating for both sides. I requested a feature in a framework, and the report was closed as “Working as intended.” I grudgingly worked around the missing functionality. Next WWDC, a sister framework was announced that was capable of doing what I needed. So from my perspective, engineers agreed with me that the functionality was needed but weren’t able to tell me that they were working on it in a new framework. “Working as intended” was both accurate and misleading!

ios owner
Guest
ios owner

They don’t really have a crackerjack team at Apple – do they :( Maybe they need to fix that first?

Fionn
Guest
Fionn

Since there’s no way of officially reporting Apple Music bugs (pity, because it’s arguably their most bug-ridden service), I’ve tried to do it with their Twitter support. They are utterly unwilling to admit the existence of a bug and they will do everything possible to slightly change the topic enough times until you give up. I’ve gotten links to help articles for other features and been told a bug is ‘as designed’. This is the frustration that made me stop using Microsoft products 8 years ago.

trackback

[…] via corbinstreehouse […]

trackback

[…] @nibroc shared a post about the ugly details for how bugs are dealt with at Apple (spoiler alert: not well, or consistently), I enjoyed seeing my feelings echoed by someone much […]

PissedDeveloper
Guest
PissedDeveloper

I have filled bugs for 10 years. After realizing none of my bugs got ever fixed, I stopped filling them. Apple hates developers. They give us subpar tools as Xcode and most of their docs, that are a piece of crap. They don’t give a crap to developers. At one time they were giving hardware discount to musicians and not to developers. They have almost live support to book authors and musicians. Developers for them, are crap.

trackback

[…] Apple. The “What can you do?” section of Corbin Dunn’s well-publicized blog post “The Sad State of Logging Bugs for Apple” is far too thin. The post is mostly inside baseball on how bugs are screened at Apple. Neither you […]

trackback

[…] The Sad State of Logging Bugs for Apple […]

(c) 2008-2019 Corbin Dunn

Privacy Policy

Subscribe to RSS feeds for entries.

131 queries. 0.495 seconds.

Log in