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)

I can't think of a perfect place for this landing page, which is one
reason why hijacking reference/mysql feels like an option. It does not
belong in our overloaded appendix. One concern: it may confuse users who
expect reference/mysql/ to only contain ext/mysql info. Maybe.

What do people think? I prefer (1) but would understand (2) or perhaps a
new option as (3).

Regards,
Ulf


PS: MySQL is certainly the most extreme example but there are other cases too where a landing page could come handy for readers.

DB
  Abstrations
   PDO
    link to PDO_MySQL

  Vendor Specific

   SQLite
    SQLite
    SQLite3

   MySQL
    mysqli
    mysqlnd
    mysqlnd_ms
    mysqlnd_qc
    mysqlnd_uh
    mysql

Other
  Memcache
   Memcache
   Memcached

XML
  SDO
  SDO-DAS-Relational
  SDO_DAS_XML

Reply via email to