A year ago I wrote this – How the WordPress Update Works – and, the update tool has changed, but the crazy expectations have not.
Before We Begin…
I want to reiterate this, since apparently I can’t say it enough, the auto upgrade tool will never be 100% perfect.
Part of me seriously wonders why people expect things to work perfectly all the time. The other part of me knows that if it wasn’t for WordPress getting it right so often, they wouldn’t have such violent reactions when it wasn’t. Skewered on their own swords, I guess. By making WordPress easier to install, use and upgrade, I do feel we might have lowered the bar too much, or at least beyond the current ability of servers and applications.
I feel there’s a practical limit to how ‘simple’ you can make things. It’s sort of why I hate writing ‘troubleshooting’ documents that consist of ‘If you see this error, do this.’ It stops people from thinking and troubleshooting on their own, and instead ties them to a script. You’ve been there, I’m sure, telling the guy on the phone that you already rebooted your system.
On the other hand, the vast number of people who just don’t do that is why I started writing up the Master TroubleShooting Lists for WordPress releases (this is now my third). Before 3.3 came out, I monitored the Alpha/Beta forums, the email lists, and pinged people I knew were testing the pre-release on Twitter and Google. Then I grabbed the other support geeks on the wp-forums list, asked them for advice and suggestions, and drafted up the post you see up there now. Well, except not. That post has been edited by anyone with moderator access on the forums (something I encourage and support, by the way).
What does all that have to do with how the upgrade works? It’s simple. If you don’t want to take the time to understand how a process works, what it entails, how it’s tested before release, and what goes into installing it for you, I don’t want to help you. Actually, no one does. One of the last things anyone in support wants to hear is ‘You don’t understand…’ (First place goes to anyone who says ‘It doesn’t work.’ and won’t tell you what ‘it’ is, what the error is, or anything useful.)
How Does The Upgrade Work?
Many things are still the same. WordPress downloads the files, replaces them, runs the ‘deprecated file list’ and deletes only those files. What’s new is that, as of WordPress 3.2, we only upgrade the newer files!
Faster Upgrades — The update system now support incremental upgrades so after 3.2 you’ll find upgrading faster than ever
This made the 3.2.1 upgrade really fast for everyone. If you look at the release notes for 3.2.1, you’ll see a list of files at the bottom. Those were the only files that got updated when you ran an automatic upgrade, which is really cool. And when you look at the notes for version 3.3, you don’t see those files. Why not? The first reason is there are a lot more files. In fact, I’m willing to bet most files are touched in an update from 3.2 to 3.3 (those are major releases, by the way). So listing the files would be crazy. The second reason is that a major release isn’t viewed the same way as a minor release. We’re supposed to expect big changes.
I started working my way through the code before I gave up and asked Nacin if the 3.2.1 to 3.3 used the incremental or the full upgrade? My gut feeling was, based on how long it took, it was a full upgrade. Nacin was quick to confirm that, elaborating by saying those are only done for partial releases, though the update was smaller than before, since it omitted the wp-content folder. This isn’t new, by the way.
So basically the upgrade hasn’t changed. Which begs the question…
Is WordPress 3.3 ‘Worse’ Than 3.2?
This goes back to my Master List posts. The whole reason I started them was that 2.9 to 3.0 was insane. It was huge. It was crazy big, with lots of changes, and lots of visceral reactions. “I hate this, I hate that, I hate you.” I’m currently ignoring (most of) the people who are doing that. I get that you’re unhappy things aren’t perfect, but I’m going to put this out there: You’re being irrational.
Now, it’s okay that you’re angry. I mean, your site is ‘broken’ and you’re upset. It’s justified. But from our end of helping you, it’s like trying to negotiate with a truculent five year old. You won’t listen to reason, you just want us to fix it, now, and by the way it’s totally our fault that everything broke. I don’t mollycoddle people when they start loosing their blob like that. I walk away and wait for them to comprehend reality.
No, 3.3 isn’t ‘worse’ than 3.2. And it’s not, generally, WordPress’s fault your site broke. It’s not anyone’s fault, actually.
Just like everyone waiting (or delaying) filing their taxes until the last day, plugin and theme developers also sometimes put off the seemingly minor task of checking their plugin or theme with the new version of WordPress. In fact, a shockingly high number wait for the release candidate. I said this before, if you make your living on WordPress, you damn well better test earlier. Sure, it makes sense that people like me (who actually don’t WordPress for a living) don’t always test in time. On the other hand, if you’re a professional, you’re remiss in your responsibility by not doing that.
And even then, you can still miss something. My best WordPress Friends missed a bug in their plugin. They do this for a living. How did that happen? It happened to be a feature you don’t often go and change. They had tested ‘does this still work when I upgrade?’ and that was hunky dory. But this one thing that only gets used when you’re doing one specific thing, that people only use once, that wasn’t working. Oops. You can see how that got missed. They just didn’t test it. It happens, they worked out a fix, and it’ll be out soon. Those are understandable misses because you can’t test everything. Maybe they’ll make a checklist of things they must test on a major upgrade, but then again, this plugin had survived multiple other major upgrades. It’s hard to say.
But what about when it’s your plugin plus someone else’s theme plus the new version of WordPress? Now it’s harder, because you get an IDIC epidemic(That is possibly my favorite Star Trek novel, by the way.) with WordPress. IDIC is a Star Trek concept. The Vulcans believed in “Infinite Diversity in Infinite Combinations” which I think is a perfect way to explain the problem.
It’s because of both the myriad complications thrown in by the incalculable customized installations that, when people say the upgrade broke them, I have to do the thing I despise and ask them “Did you read the Master List and try everything?” I actually do wince every time I paste that link in. It is with a resigned sigh that I hit enter. I don’t want to have to say that, but when I see people posting ‘It doesn’t work’ or ‘Help! My site is broken!’ without any information as to what they’ve already tried, I look at the volume of posts and assume they did nothing.
I tweeted at one point “I’ll stop posting stock replies when you stop posting it didn’t work.”
It’s a give and take. You have to give a little information if you expect people to help. And not one of us thinks this install is 100% rock solid perfect. 3.3.1 is already on the docket with a couple things, including putting support for people with no DB prefix.
Invariably we’ll all find something new and horrible to add to the master list. Like this time, I had to put ‘flush all your caches’ because, when WP changed the jQuery to 1.7.1, some browsers decided they weren’t going to update the local cache like they’re supposed to. The amount that pissed me off is huge. Also, as Nacin groused, the core devs yet again missed a JSON issue. One bitten, twice WTF? as he put it.
For the most part, the real issues people have with 3.3 aren’t technical issues, they’re user issues. People love/hate the flyout menus, the toolbar (oh dear god the tool bar) and the uploader. They hate that not all their plugins work, they hate hate hate. It’s wearing, you know. And we, the happy Half-Elf volunteers out there want to help you fix things. But if you’re not going to accept that problems are usually bigger than just WordPress, we can’t help you.
Like the Database needing repair, okay? Some people had to repair their DB. Guess what? This isn’t just a WordPress issue. I ran a major upgrade on a webapp for work last month, and the damn thing did the same thing! I had to repair the DB to get it to work. This is because, as I know, I’m making some major changes to a database, and if there’s any sneeze on the sturdy tubes of the Intarwebz, then I may have a weird glitch. This is why, again, I tell people to manually upgrade. These problems are cause by the upgrade, but they aren’t WordPress‘s fault. They just happen. A thousand times you add a post, and one time it causes your database to crash. That’s uncommon, but not impossible, and that is what people fail to grasp.
You’re experiencing uncommon problems.
Don’t Lower Your Expectations, Raise Your Understanding
Sometimes I think people get the wrong idea when I talk about this sort of thing. You think I want you to give support people more of a break, and while I do, it’s for the same reason I want you to give your coffee barrista a break(Best coffee I’ve ever had, no lie, was when I told the overworked barrista “Take your time, if the jerk is in a rush, I’ll wait.” It cost me ten minutes, and they gave me the best coffee ever. One size larger.), or the chasier at the DMV. Treat people like people, because that’s the right thing to do.
Instead, you should learn more. Understand more. Take the time to go “I hate this. Why did they do it?” and then, instead of making that angry shit-distributing, post, learn something. With very little effort, a person can scroll down to the Alpha/Beta forums on WordPress and see if this problem was reported before. A slightly more experienced person knows about the blogs the devs use, and one step up from that, you know trac. Trac’s a little scary when you’re new, and search it is complicated, don’t get me wrong.
But see, the ‘geniuses’ who are helping you at all your problems? We’re just people like you. And we just have an idea of the lingo and what we’re really looking for on Google. And we would really like it if you could treat us like people before you lose your mind.
We’d also like it if you read, and thought, before you said ‘this is broken.’ Mind you, I think that of the guys I teach to solve problems. Listen to what people say, pay attention and try to draw better explanations from them, and solve the real problem. The number of times I’ve watched people just throw a rote answer at the wrong problem drives me nuts. But so do ‘web developers’ who don’t understand what FTP is.
If you’re going to run a website, even though apps make it easy on you, there’s no excuse for not learning what you’re doing. I don’t mean you need to learn how to write code, but just as I feel everyone needs to know how to jumpstart their car and change a tire (or patch one, if you ride a bike), it’s in your best interest to have at least a basic understanding of the magic that is the internet. And if the website is your life (as so many people on the forums short), well, then so is learning that. A chef knows how to use the fridge and sharpen knives because it’s expected of them. While a fashion designer may not be the best at sewing, they know how clothes are put together.
See the theme here? Know what you’re doing. Understand what’s behind your art.
Otherwise? Well, WordPress.com has fantastic hosting options and I send many people to them.
Comments
14 responses to “WordPress Upgrades and You”
Turning Complexity Theory into a Star Trek reference, that’s awesome!! 😆
You’re welcome. 💡
Faux pingback from my former cowoker, Beebear (he retired and we keep in touch). The whole ‘It doesn’t work!’ epidemic drives him up the wall too. He read this and posted his own: How to Get Good Customer Support
“Manually update” means downloading from wordpress.org and then FTPing the whole thing to your server, correct?
Yep. The way we used to do it in the old days, before people had invented auto-update.
I checked out the official instructions at http://codex.wordpress.org/Updating_WordPress#Manual_Update and now I’m wondering why I can’t grab the whole thing like I was doing a fresh install (instead of the “delete x folders, overwrite y folders, etc.).
1) Deleting wp-admin and wp-includes is safe as houses. None of your data will be harmed unless you modified core. Which you didn’t. Right?
2) Because sometimes, when you overwrite files, things go silly on you.
Thanks for explaining. I do not play around in WP’s core.
Yikes. Makes me feel sorry for the WP newbies out there. I totally understand where you’re coming from, but a lot of the newbies are like one of the four sons on Passover: “she-eino yodeyah lishol” – they don’t even know what to ask. For example, the newbie WP user whose db crashes. All they know is that one minute their posts are there, the next they’re gone. Freaking out is a reasonable next step since they don’t know that db’s crash and can be repaired.
What I’m trying to say is, that only once users have accrued a certain amount of knowledge can they start to ask the right questions. But at the same time, they definitely shouldn’t expect volunteers to jump and serve them immediately, and kvetch the whole time they’re doing so.
And that is very much why I hate having to say what I do to them.
It’s like having a hundred 4th children, but worse, because none of them want to learn enough to become the 1st one. In fact, I don’t mind the 4th children as much as the 2nd one :/ And explaining that concept when you’re teaching people how to help newbies is … Well I’ve only succeeded if the student’s been to a Passover Seder.
Freaking out is fine. I except that. I accept it. But I don’t understand, and probably never will, why people refuse to stop and think. Why they think it’s okay to just scream and scream and that someone will come help them. Why there’s no expectation on them to step up and go “Okay, I’m freaking out, but what did I do and how can I fix it… I don’t know. I need help. Can you help?”
They have to be willing to try.
Let’s just look at this guy: http://wordpress.org/support/topic/insert-media-crashes-sucks
No information as to what debugging he did.
No ‘I upgraded and…’
Only a passing mention to ‘a plugin’ that only works with the uploader, but no details.
Yeah, I know. I wonder if there’s some way to guide newbies as to how to ask questions. But if they’re so newbie, they won’t even know to look at this type of guide, even if it existed. Catch 22.
When it’s kids, I get it. But when grown adults who, presumably, have been through high school, who’ve had to say ‘My car isn’t running’ to a mechanic, or ‘My stomach hurts’ to a doctor, should have experienced at least a modicum of critical thinking.
I believe these newbies already know how to think. They’re just in panic mode and revert to being children. And an adult should be able to take a deep breath and know they’re panicking without letting it control them. I mean, it’s not like their leg is hanging off by it’s sinews.
Great article. New users can be alarmed when putting so much work into a site to have it go bye-bye because there was a problem with the upgrade. WordPress has done an awesome job of helping just about everyone build a website and get online. Unfortunately, even though it is easy, it’s not exactly as comfortable as the .com free version because there is less stress about upgrading, security issues, caching and such. But I highly agree that yes, raising the understanding of WP is what needs to be done. Because really, out of all the free self-hosted CMS type platforms out there, this one has the lowest learning curve. Biggest lesson – is to backup your site….just in case!