Better update instructions?
I just wanna petition for better instructions on the whole upgrading bit.
WordPress really shines for making things simple, but I’m afraid the brevity of the instructions included in the zip file “readme.html” file are rather unnerving to follow.
I don’t run an FTP server, because I don’t need an FTP server. So automated updates aren’t really an option. I’m fine with manually extracting an archive into my wordpress root, but here are a few things I’d like to see out of the upgrade directions:
1) Delete your old WP files, saving ones you’ve modified.
1) Delete your old WP files, except for themes, plugins, or anything else you’ve modified. Oh, and don’t nuke your wp-config.php file, because that’s kind of important.
(( step 2 is fine: Upload the new files. ))
3) Point your browser to /wp-admin/upgrade.php.
3) If you nuked your wp-config.php in step one (since we didn’t remind you that you should have kept it), dig around in your other projects to remember what the hell your database password was. Then continue.
4) Read the next message about how you’ve already got WP installed, and that you should now drop your database.
5) Scream in agony because it sounds like you’ve just broken the entire thing. Looks like you’ve got to start over, rewriting that post that you didn’t back up because you thought this was supposed to be easy.
6) But wait– disregard that nonsense in step 5. You’ve actually succeeded, since giving WP you database info again secretly performed the task required, yet not-so-cleverly dumped you an inaccurate page.
7) Heh, you thought that was all? You forgot to do a recursive chgrp and chmod on the whole operation to get your apache user (www-data or the like) write-permissions.
It was strange to me that simply unzipping the archive over top of my old setup wasn’t enough, and that an update attempt could not be detected when I visited that /upgrade.php link.
Am I the only one thinking that step one being “delete everything” is a little bit strong, and should sacrifice brevity for better info? I’ll of course know how this whole things goes down in the future, but I wasn’t exactly comfortable doing an upgrade for the first time. I have to believe that there are more people out there who defer upgrading because they aren’t really keen on deleting their whole blog without any more instructions than are given. I delayed upgrading since version 2.6-something.
- The topic ‘Better update instructions?’ is closed to new replies.