WordPress Upgrade Documentation
There has been some discussion on the wp-hackers and wp-docs about what a potential Upgrade documentation for WordPress 1.6 should look like.
I’m not a proponent of “simple is better” in documentation. At least, in terms of the WordPress upgrade, there is very little to do on the WordPress end to upgrade your system to the new version. Essentially, you push a button. But there are some steps you need to take before you get to that point to make sure everything runs smoothly, and that’s where adequate documentation comes into play.
I was thinking about what “Web 2.0” documentation looks like. We’re trying to play off WordPress as a state-of-the-art content management system. So why not have state-of-the-art documentation? The Codex is a good resource for WordPress, but there are users of WordPress that never need to know how to customize their software. These users will only want to know how to upgrade their installations, and the documentation should hold their hand through the process. So I assembled this silly mockup of what I imagined Web 2.0 documenation looked like.