Video game nerdery ahead.

It's pretty safe to say the 1.1.4 update coming to Destiny 2 tomorrow is a big deal. It's an attempt to respond to criticisms of the game's shortcomings when it comes to the gameplay tuning, pretty much across the board—and it took Bungie over six months from launch to get to.

Lots of people are looking to this patch to reinvigorate some of the game and bring some excitement back to both PvE and PvP modes. It's been termed the "Go Fast" update, because it has tweaks to player movement, ability recharge rates, and some gunplay bits.

The notes won't drop until tomorrow, but I want to take a few to talk about patch notes and what makes for good game patch notes. At least so far, Bungie hasn't provided good patch notes for a game that a lot of hardcore players study down to specific numbers. In fact, just today, one day before the update, the main subreddit for the game has been publishing or republishing a lot of numbers, like these:

These posts have very specific numbers that are based on measurements being taken by players that have no access to the underlying math of the game—they are all based on observation. There's a post like this probably every week somewhere, detailing something and including numbers to show the work.

They shouldn't have to do this all over again; post-patch, the patch notes should give them all the information they need. I'll explain. Bungie's patch notes have previously looked like this (and yes, this is a bit cherry-picked, but it's representative and is from this update):

  • Increased the base damage and reduced the precision modifier of Precision Auto Rifles
  • Slightly reduced the aim deflection of High-Caliber Rounds on Auto Rifles and Scout Rifles
  • Reduced the effectiveness of Aim Assist at higher ranges on Scout Rifles
  • Reduced severity of recoil on Hakke High-Impact Auto Rifles
  • Hand Cannon accuracy recovery now scales with rate of fire
  • Improved base Aim Assist on aggressive Hand Cannons
  • Slightly increased the rate of fire time between bursts on all Omolon Sidearms
  • Slightly increased impact damage on lightweight single-shot Grenade Launchers

These aren't good patch notes. They leave me with tons of unanswered questions.

How much more damage will my Precision Auto Rifle do now? Why are you making it less precise, and how? High-Caliber rounds deflected aim before? What do you mean, and how is that changing? How much is "slightly," and does that mean roughly the same across the various notes, or does it stand for a range of values?

Almost everything in these notes is pretty vague.

Good patch notes should:

  • Tell you what changed.
  • Tell you how much and in what direction.

Great patch notes will also:

  • Tell you why something was changed.

The best example of this is almost certainly Killer Instinct. KI had the best patch notes of any game I have ever seen, followed pretty closely by Diablo III. Here's a great example of KI patch notes that accomplish this:

Fulgore:

  • [Fulgore has been pretty difficult to balance. We’ve adjusted his rushdown, his zoning, and his instinct during Season 3 and he is still an extremely powerful character, which shows how tricky it is to find the sweet spot for him. Now that the dust has settled a bit, the team feels confident that Fulgore now has the weaknesses we intended him to have, but on the journey to this spot, we went a little far in a few areas. These buffs will not send Fulgore over the top again, but should help with some small quality of life aspects of his game.]
  • Raised Energy Bolt damage by 42% (from 7 to 10) [This gives him more zoning damage and more damage on his Energy Bolt into Teleport mixups]
  • Raised Light Cyber Uppercut damage 33% (from 15 to 20)
  • Raised Medium Cyber Uppercut damage 16% (from 12 to 14) [Usually, you’d expect the heavy version of a move to do the most damage, but in this case we wanted the reverse. The benefit of the light uppercut is the highest damage and most invulnerability, while the benefit of the heavy version is more potential damage left behind and multiple hits.]
  • Light and Medium Eye Lasers can now be Pip Cancelled into Energy Bolts. Heavy Eye Beam still cannot be. [This is a big buff to pip cancels and these versions of Eye Lasers, and as a result, his instinct mode as well.]
  • The minimum reactor spin speed has been increased slightly. It now takes about 10 seconds at the lowest speed to build one pip, instead of 12.5 seconds. [Fulgore’s weakness should be the odd way in which he gains meter. The old instinct mode gave him so much free meter per game that this weakness didn’t matter. Now that we have things functioning the way we want, we feel his default ‘slow’ meter gain is just a hair too low. Over the course of an average match, this should result in 3 to 5 more pips than you used to get.]

For real: these notes are amazing. Fulgore was a special case in that specific update, but these notes accomplish everything they should:

  • They tell you exactly what changed, and don't leave anything out.
  • They give you exact numbers for the changes, so there's no guesswork as to the extent of the changes.
  • They tell you why things were changed and what the intentions of the development team were when they made the change.

Look through the rest of that patch's notes, and you'll see more of the same. Specific, well-documented patch notes that indicate not only the exact changes made to the game, but the thought process behind them.

And look: I know these are two different game genres. One is a 2D fighting game with a limited amount of movement on a plane, and the other is a 3D first-person shooter with lots of complicated environmental and player-vs-player interactions to keep in mind.

But when you get down to it, it's still adjusting math and systems. This information is available to someone, somewhere. (If it's not available internally, there are other problems afoot.) And this goes not just for Destiny 2, but all games: please don't use vague terminology when you patch your games. (Capcom with SFV is another notable offender here.) Tell your players what you are changing, whether it was a bug you fixed or is a new adjustment, and why you are making the change and what you hope to accomplish with it.

They'll most likely appreciate it.