On Mon, Oct 31, 2011 at 14:29, Ulf Wendel <ulf.wen...@oracle.com> wrote: > Hello everyone, > > The MySQL team is considering ways to cleanup and clarify the MySQL > documentation. Two main reasons: > > a) ext/mysql will be deprecated in the (distant) future > > b) there are already 7 MySQL extensions > > - mysql, mysqli, pdo_mysql > - mysqlnd > - mysqlnd_qc, mysqlnd_ms, mysqlnd_uh > > > .. a word on a) to prevent misinformation: using the old mysql extension for > new developments is not recommended, http://news.php.net/php.internals/53799 > . The docs will be updated accordingly to give migration hints. Users are > requested to either make use of mysqli or pdo_mysql. > > One idea is to turn the current php.net/mysql into a MySQL landing page. > So, either: > > (1a) Use xml:id=intro.mysql as the landing page > (1b) Move mysqli.overview to mysql.overview > (1c) Probably a few other things, and as such, hijack reference/mysql/ > -- or -- > (2) Keep the info separate from reference/mysql (but have > php.net/mysql redirect elsewhere) > [...] > > XML > SDO > SDO-DAS-Relational > SDO_DAS_XML >
I really hated the SDO/SCA situation when it came around few years ago, but never managed to do anything about it. Since our core sections are <set>s these days we can stack up additional steps if we want like you are suggesting. I like option#1, groupping all the mysql* exts into <book>s together into its own <set>, keeping the xml:id BC, with the exception of intro.mysql serving as a "welcome to the MySQL infopage". -Hannes