Landing page for MySQL materials
| From: | Ulf Wendel | Date: | Mon, 31 Oct 2011 13:29:14 +0000 |
| Subject: | Landing page for MySQL materials | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969383316@lists.php.net to get a copy of this message | ||
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_MySQLVendor 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