Clarity In Writing, or “How To Tell If You’re Not Giving Enough Information”

My Macbook just informed me I have a software update that needs to be installed, one Keyboard Firmware Update 1.0. Being a systems administrator for a large number of computers means many things, one of which is paying attention to what new software updates actually do.

Software

Here is what the update description has to say (emphasis mine):

This MacBook and MacBook Pro firmware update addresses an issue where the first key press may be ignored if the computer has been sitting idle. It also addresses some other issues.

Apple has always (at least since the introduction of OS X) erred on the side of too little information, apparently in an effort to protect their users from the complexity of the machines. Just ask me to describe the contortions I put the OS through every year to get clients and servers integrated into our environment, then compare that to the OS X Server documentation posted to Apple’s website, and you’ll get an idea of just how much Apple leaves unsaid.

This, however, is not some obscure way to make a client machine authorize users on an Open Directory server while authenticating their passwords on a separate Kerberos server. This update will be seen by nearly every person who owns a Macbook or a Macbook Pro. Someone in the technical documentation department at Apple didn’t put enough effort in on this one.

Leave a Reply