update installation docs (#374)

Author: aminalaee

docs/index.md

@@ -37,7 +37,8 @@ $ pip install databases[mysql]
 $ pip install databases[sqlite]
 ```
 
-Driver support is providing using one of [asyncpg][asyncpg], [aiomysql][aiomysql], or [aiosqlite][aiosqlite].
+Driver support is provided using one of [asyncpg][asyncpg], [aiomysql][aiomysql], or [aiosqlite][aiosqlite].
+Note that if you are using any synchronous SQLAlchemy functions such as `engine.create_all()` or [alembic][alembic] migrations then you still have to install a synchronous DB driver: [psycopg2][psycopg2] for PostgreSQL and [pymysql][pymysql] for MySQL.
 
 ---
 
@@ -91,6 +92,8 @@ for examples of how to start using databases together with SQLAlchemy core expre
 [sqlalchemy-core]: https://docs.sqlalchemy.org/en/latest/core/
 [sqlalchemy-core-tutorial]: https://docs.sqlalchemy.org/en/latest/core/tutorial.html
 [alembic]: https://alembic.sqlalchemy.org/en/latest/
+[psycopg2]: https://www.psycopg.org/
+[pymysql]: https://github.com/PyMySQL/PyMySQL
 [asyncpg]: https://github.com/MagicStack/asyncpg
 [aiomysql]: https://github.com/aio-libs/aiomysql
 [aiosqlite]: https://github.com/jreese/aiosqlite

scripts/README.md

@@ -1,9 +1,11 @@
 # Development Scripts
 
+* `scripts/build` - Build package and documentation.
 * `scripts/clean` - Delete any build artifacts.
+* `scripts/docs` - Run documentation server locally.
 * `scripts/install` - Install dependencies in a virtual environment.
-* `scripts/test` - Run the test suite.
 * `scripts/lint` - Run the code linting.
 * `scripts/publish` - Publish the latest version to PyPI.
+* `scripts/test` - Run the test suite.
 
 Styled after GitHub's ["Scripts to Rule Them All"](https://github.com/github/scripts-to-rule-them-all).

scripts/docs

@@ -0,0 +1,10 @@
+#!/bin/sh -e
+
+export PREFIX=""
+if [ -d 'venv' ] ; then
+    export PREFIX="venv/bin/"
+fi
+
+set -x
+
+${PREFIX}mkdocs serve