Berker Peksag added the comment: Could you also change the function signatures from .. method:: execute(sql, [parameters]) to .. method:: execute(sql[, parameters]) and document that parameters should be list (or sequence or iterable -- I'm a the airport now so I can't check what is the correct term)? I'm not a native speaker but this sentence sounds a bit weird to me: This is a nonstandard shortcut that creates a cursor object by calling the cursor method, calls the cursor's :meth:`execute <Cursor.execute>` [...] Perhaps it can be changed to This is a nonstandard shortcut that creates a cursor object by calling the cursor's :meth:`execute <Cursor.execute>` method [...] Also, please change the following usages :meth:`execute <Cursor.execute>` with :meth:`~Cursor.execute` ---------- versions: +Python 3.5 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27188> _______________________________________