diff --git a/doc/src/faq.rst b/doc/src/faq.rst index 2c6debd0..926b05e6 100644 --- a/doc/src/faq.rst +++ b/doc/src/faq.rst @@ -7,6 +7,30 @@ Here are a few gotchas you may encounter using `psycopg2`. Feel free to suggest new entries! +Meta +---- + +.. _faq-question: +.. cssclass:: faq + +How do I ask a question? + - Have you first checked if your question is answered already in the + documentation? + + - If your question is about installing psycopg, have you checked the + :ref:`install FAQ ` and the :ref:`install docs + `? + + - Have you googled for your error message? + + - If you haven't found an answer yet, please write to the `Mailing List`_. + + - If you haven't found a bug, DO NOT write to the bug tracker to ask + questions. You will only get piro grumpy. + + .. _mailing list: https://www.postgresql.org/list/psycopg/ + + .. _faq-transactions: Problems with transactions handling diff --git a/doc/src/install.rst b/doc/src/install.rst index 98db5608..053b2bb6 100644 --- a/doc/src/install.rst +++ b/doc/src/install.rst @@ -1,4 +1,6 @@ -Introduction +.. _installation: + +Installation ============ .. sectionauthor:: Daniele Varrazzo @@ -327,5 +329,5 @@ Try the following. *In order:* ever and about the quality time you have wasted figuring out the correct :envvar:`ARCHFLAGS`. Especially useful from the Starbucks near you. -.. _mailing list: https://lists.postgresql.org/mj/mj_wwwusr?func=lists-long-full&extra=psycopg +.. _mailing list: https://www.postgresql.org/list/psycopg/ .. _bug tracker: https://github.com/psycopg/psycopg2/issues