Versioned Manual
For years I and several others have been asking for the MySQL online manual to be versioned. It’s very annoying to users to see something in the manual and not have it work in their instance of MySQL. I’ve mentioned this a few times and now it looks like it’s come true. The manual page now has version numbers!
Good job guys. Thanks!
October 16th, 2005 at 11:40 am
You are welcome, its one of the things that I pushed since it annoyed me as well
-Brian
October 18th, 2005 at 1:45 pm
This is much better. the 4.1 manual is still missing pieces I believe. I think one is the instance manager, which was introduced for MySQL 5.0, and then back-ported in one of the releases of 4.1. It would be nice to see that in the 4.1 manuals, since it is an executable that is released under that version.
- Partha
October 26th, 2005 at 9:14 am
How come they don’t just have a different set of docs for each version. I’d find it much easier to just download the 4.1 docs and not have to read a bunch of info about the 3.x or 5.x versions to find the 4.1 info I need.
Imagine if the apache 2.0 docs were full of “oh by the way, this works in version 1.3, this works in 2.0″ etc… all through them. They’re different versions, they really deserve different doc sets.
But this is a step in the right direction. It drove me insane when 4.0 etc came out and you couldn’t tell what worked in 3.x anymore reading the docs. It was just kind of assumed that if you were using 3.x you must have been using it for the last couple years and you’d just know that this feature was new.
OTOH, the update to the docs did get rid of the anti-oracle / postgresql fud pages, so it wasn’t all a bad thing.
What would be coolest would be a web based app that you could pick the ranges of versions to include, so you could include only features for certain version(s), etc…