From 91a8962770a74fd8bd7654cb5fb92f1a83d73b5e Mon Sep 17 00:00:00 2001 From: Daniele Varrazzo Date: Mon, 10 Jun 2019 23:18:11 +0100 Subject: [PATCH] Added entry about how to ask questions Also fixed mailing list link (although it doesn't seem there's a link to a subscription page anymore, you have to go through the community portal). Close #930. --- doc/src/faq.rst | 24 ++++++++++++++++++++++++ doc/src/install.rst | 6 ++++-- 2 files changed, 28 insertions(+), 2 deletions(-) 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