diff --git a/content/contact.md b/content/contact.md index 6d9950e..9113086 100644 --- a/content/contact.md +++ b/content/contact.md @@ -12,19 +12,14 @@ your own projects that use any of our libraries; do not post images of code, and use a paste site like for long blocks of code. Use the `#random` channel to post about projects, libraries, and programming news. -The project-specific channels are reserved for contributor discussion, not for -general questions. If you are contributing to one of our projects and need to -discuss anything, use the `#get-access` channel to be able to post. +The `Contributing` category of channels are reserved for contributor discussion, +not for general questions. Do not post there unless you are contributing to a +Pallets project. The IRC channel ``#pallets`` on is connected to the ``#questions`` channel on Discord. In Discord you'll see a `bot` label for IRC users; in IRC you'll see a `Pallets-` prefix for Discord users. -## GitHub Discussions - -You may use a project's GitHub Discussions tab to ask questions. This is more -permanent than chat, and allows feedback and accepting answers. - ## Reporting Security Issues Responsibly report security issues by [drafting a private security advisory][advisory] diff --git a/content/contributing/index.md b/content/contributing/index.md index 9498590..699798a 100644 --- a/content/contributing/index.md +++ b/content/contributing/index.md @@ -79,10 +79,9 @@ issues include: - Improve static type annotations. We target mypy primarily, but would also like to improve compatibility with pyright. We also want to ensure we are using types correctly, and add tests. -- Answer questions on GitHub Discussions and our Discord chat server. - Referencing canonical sources and providing explanation beyond the immediate - answer creates resources for others to find later and enables them to answer - in turn. +- Answer questions on our Discord chat server. If the answer was hard to + find in canonical sources, or required additional explanation, it might + be good to add it to our documentation for others to find next time. ## Get Help Contributing diff --git a/content/contributing/questions.md b/content/contributing/questions.md index f195992..67cc6a3 100644 --- a/content/contributing/questions.md +++ b/content/contributing/questions.md @@ -9,9 +9,6 @@ your own code: name and a specific search term such as an error message. - Ask in the `#questions` channel on our Discord chat: . -- Use the project's GitHub Discussions tab for long term discussion or - larger questions. Each project has its own Discussions tab. For example, - Flask's is here: . ## How to Ask @@ -46,9 +43,9 @@ to you. ## How to Answer -A great way to contribute is to answer questions asked on Discord or the -project's GitHub Discussions tab. The more people answer helpfully, the more -people will want to ask and participate, and our community will grow. +A great way to contribute is to answer questions asked on Discord. The more +people answer helpfully, the more people will want to ask and participate, +and our community will grow. Try to answer questions directly and politely. After answering the immediate question, it's fine to suggest other improvements, or ask followup diff --git a/content/contributing/triage.md b/content/contributing/triage.md index d30b028..a3d450e 100644 --- a/content/contributing/triage.md +++ b/content/contributing/triage.md @@ -7,10 +7,9 @@ make; this page is a loose collection of guidelines to keep in mind. Close issues or ask for clarification as needed. Determine if the issue is with the Pallets library. Issues with the user's own -code should be asked as [questions] instead, use the "Convert to discussion" -link at the bottom of the sidebar. Issues with another library, often indicated -by a traceback pointing to other code, should be reported to that library -instead. +code should be asked as [questions] on Discord instead. Issues with another +library, often indicated by a traceback pointing to other code, should be +reported to that library instead. [questions]: questions.md