docs: Update the Contact document

Try to make it more clear that Discord is not Discourse, as the two
similarly sounding services are often confused by users unfamiliar
with them.

The Klipper Discourse and Klipper Discord are available for many
topics related to Klipper - reword some sections to make their use
more open.

Avoid referring to the Klipper github repo in this Contact document as
we no longer use Klipper github issues at all.

Remove the table of contents as it is largely redundant for the
document.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2023-10-30 16:32:49 -04:00
parent bee7ec720b
commit 03982f2c7e
4 changed files with 26 additions and 54 deletions

View File

@ -34,7 +34,7 @@ jobs:
+ " bulk of a review has already been completed." + " bulk of a review has already been completed."
+ "\n" + "\n"
+ "2. Consider opening a topic on the [Klipper Discourse]" + "2. Consider opening a topic on the [Klipper Discourse]"
+ "(https://www.klipper3d.org/Contact.html#community-forum)" + "(https://www.klipper3d.org/Contact.html#discourse-forum)"
+ " server to discuss this work. The Discourse server is a good" + " server to discuss this work. The Discourse server is a good"
+ " place to discuss development ideas and to engage users" + " place to discuss development ideas and to engage users"
+ " interested in testing. Reviewers are more likely to" + " interested in testing. Reviewers are more likely to"
@ -50,7 +50,7 @@ jobs:
+ " this GitHub Pull Request then it will be automatically" + " this GitHub Pull Request then it will be automatically"
+ " closed. If this happens, then it is a good idea to move" + " closed. If this happens, then it is a good idea to move"
+ " further discussion to the [Klipper Discourse]" + " further discussion to the [Klipper Discourse]"
+ "(https://www.klipper3d.org/Contact.html#community-forum)" + "(https://www.klipper3d.org/Contact.html#discourse-forum)"
+ " server. Reviewers can reach out on that forum to let you" + " server. Reviewers can reach out on that forum to let you"
+ " know if they are interested and when they are available." + " know if they are interested and when they are available."
+ "\n\n" + "\n\n"

View File

@ -83,7 +83,7 @@ jobs:
+ " this GitHub Pull Request and it is therefore being" + " this GitHub Pull Request and it is therefore being"
+ " closed. It is a good idea to move" + " closed. It is a good idea to move"
+ " further discussion to the [Klipper Discourse]" + " further discussion to the [Klipper Discourse]"
+ "(https://www.klipper3d.org/Contact.html#community-forum)" + "(https://www.klipper3d.org/Contact.html#discourse-forum)"
+ " server. Reviewers can reach out on that forum to let you" + " server. Reviewers can reach out on that forum to let you"
+ " know if they are interested and when they are available." + " know if they are interested and when they are available."
+ "\n\n" + "\n\n"
@ -137,7 +137,7 @@ jobs:
+ " bulk of a review has already been completed." + " bulk of a review has already been completed."
+ "\n" + "\n"
+ "2. Consider opening a topic on the [Klipper Discourse]" + "2. Consider opening a topic on the [Klipper Discourse]"
+ "(https://www.klipper3d.org/Contact.html#community-forum)" + "(https://www.klipper3d.org/Contact.html#discourse-forum)"
+ " server to discuss this work. The Discourse server is a good" + " server to discuss this work. The Discourse server is a good"
+ " place to discuss development ideas and to engage users" + " place to discuss development ideas and to engage users"
+ " interested in testing. Reviewers are more likely to" + " interested in testing. Reviewers are more likely to"
@ -153,7 +153,7 @@ jobs:
+ " this GitHub Pull Request then it will be automatically" + " this GitHub Pull Request then it will be automatically"
+ " closed. If this happens, then it is a good idea to move" + " closed. If this happens, then it is a good idea to move"
+ " further discussion to the [Klipper Discourse]" + " further discussion to the [Klipper Discourse]"
+ "(https://www.klipper3d.org/Contact.html#community-forum)" + "(https://www.klipper3d.org/Contact.html#discourse-forum)"
+ " server. Reviewers can reach out on that forum to let you" + " server. Reviewers can reach out on that forum to let you"
+ " know if they are interested and when they are available." + " know if they are interested and when they are available."
+ "\n\n" + "\n\n"

View File

@ -2,25 +2,18 @@
This document provides contact information for Klipper. This document provides contact information for Klipper.
1. [Community Forum](#community-forum) ## Discourse Forum
2. [Discord Chat](#discord-chat)
3. [I have a question about Klipper](#i-have-a-question-about-klipper)
4. [I have a feature request](#i-have-a-feature-request)
5. [Help! It doesn't work!](#help-it-doesnt-work)
6. [I found a bug in the Klipper software](#i-found-a-bug-in-the-klipper-software)
7. [I am making changes that I'd like to include in Klipper](#i-am-making-changes-that-id-like-to-include-in-klipper)
8. [Klipper github](#klipper-github)
## Community Forum
There is a There is a
[Klipper Community Discourse server](https://community.klipper3d.org) [Klipper Community Discourse server](https://community.klipper3d.org)
for discussions on Klipper. for "forum" style discussions on Klipper. Note that Discourse is not
Discord.
## Discord Chat ## Discord Chat
There is a Discord server dedicated to Klipper at: There is a Discord server dedicated to Klipper at:
[https://discord.klipper3d.org](https://discord.klipper3d.org). [https://discord.klipper3d.org](https://discord.klipper3d.org). Note
that Discord is not Discourse.
This server is run by a community of Klipper enthusiasts dedicated to This server is run by a community of Klipper enthusiasts dedicated to
discussions on Klipper. It allows users to chat with other users in discussions on Klipper. It allows users to chat with other users in
@ -33,37 +26,29 @@ Many questions we receive are already answered in the
documentation and follow the directions provided there. documentation and follow the directions provided there.
It is also possible to search for similar questions in the It is also possible to search for similar questions in the
[Klipper Community Forum](#community-forum). [Klipper Discourse Forum](#discourse-forum).
If you are interested in sharing your knowledge and experience with If you are interested in sharing your knowledge and experience with
other Klipper users then you can join the other Klipper users then you can join the
[Klipper Community Forum](#community-forum) or [Klipper Discourse Forum](#discourse-forum) or
[Klipper Discord Chat](#discord-chat). Both are communities where [Klipper Discord Chat](#discord-chat). Both are communities where
Klipper users can discuss Klipper with other users. Klipper users can discuss Klipper with other users.
Many questions we receive are general 3d-printing questions that are If you have a general question or are experiencing general printing
not specific to Klipper. If you have a general question or are problems, then also consider a general 3d-printing forum or a forum
experiencing general printing problems, then you will likely get a dedicated to the printer hardware.
better response by asking in a general 3d-printing forum or a forum
dedicated to your printer hardware.
## I have a feature request ## I have a feature request
All new features require someone interested and able to implement that All new features require someone interested and able to implement that
feature. If you are interested in helping to implement or test a new feature. If you are interested in helping to implement or test a new
feature, you can search for ongoing developments in the feature, you can search for ongoing developments in the
[Klipper Community Forum](#community-forum). There is also [Klipper Discourse Forum](#discourse-forum). There is also
[Klipper Discord Chat](#discord-chat) for discussions between [Klipper Discord Chat](#discord-chat) for discussions between
collaborators. collaborators.
## Help! It doesn't work! ## Help! It doesn't work!
Unfortunately, we receive many more requests for help than we could
possibly answer. Most problem reports we see are eventually tracked
down to:
1. Subtle errors in the hardware, or
2. Not following all the steps described in the Klipper documentation.
If you are experiencing problems we recommend you carefully read the If you are experiencing problems we recommend you carefully read the
[Klipper documentation](Overview.md) and double check that all steps [Klipper documentation](Overview.md) and double check that all steps
were followed. were followed.
@ -72,16 +57,15 @@ If you are experiencing a printing problem, then we recommend
carefully inspecting the printer hardware (all joints, wires, screws, carefully inspecting the printer hardware (all joints, wires, screws,
etc.) and verify nothing is abnormal. We find most printing problems etc.) and verify nothing is abnormal. We find most printing problems
are not related to the Klipper software. If you do find a problem with are not related to the Klipper software. If you do find a problem with
the printer hardware then you will likely get a better response by the printer hardware then consider searching general 3d-printing
searching in a general 3d-printing forum or in a forum dedicated to forums or forums dedicated to the printer hardware.
your printer hardware.
It is also possible to search for similar issues in the It is also possible to search for similar issues in the
[Klipper Community Forum](#community-forum). [Klipper Discourse Forum](#discourse-forum).
If you are interested in sharing your knowledge and experience with If you are interested in sharing your knowledge and experience with
other Klipper users then you can join the other Klipper users then you can join the
[Klipper Community Forum](#community-forum) or [Klipper Discourse Forum](#discourse-forum) or
[Klipper Discord Chat](#discord-chat). Both are communities where [Klipper Discord Chat](#discord-chat). Both are communities where
Klipper users can discuss Klipper with other users. Klipper users can discuss Klipper with other users.
@ -91,7 +75,7 @@ Klipper is an open-source project and we appreciate when collaborators
diagnose errors in the software. diagnose errors in the software.
Problems should be reported in the Problems should be reported in the
[Klipper Community Forum](#community-forum). [Klipper Discourse Forum](#discourse-forum).
There is important information that will be needed in order to fix a There is important information that will be needed in order to fix a
bug. Please follow these steps: bug. Please follow these steps:
@ -126,7 +110,7 @@ bug. Please follow these steps:
of the log. Only the full unmodified log file provides the of the log. Only the full unmodified log file provides the
necessary information. necessary information.
5. It is a good idea to compress the log file with zip or gzip. 5. It is a good idea to compress the log file with zip or gzip.
5. Open a new topic on the [Klipper Community Forum](#community-forum) 5. Open a new topic on the [Klipper Discourse Forum](#discourse-forum)
and provide a clear description of the problem. Other Klipper and provide a clear description of the problem. Other Klipper
contributors will need to understand what steps were taken, what contributors will need to understand what steps were taken, what
the desired outcome was, and what outcome actually occurred. The the desired outcome was, and what outcome actually occurred. The
@ -136,22 +120,10 @@ bug. Please follow these steps:
Klipper is open-source software and we appreciate new contributions. Klipper is open-source software and we appreciate new contributions.
New contributions (for both code and documentation) are submitted via See the [CONTRIBUTING document](CONTRIBUTING.md) for information.
Github Pull Requests. See the [CONTRIBUTING document](CONTRIBUTING.md)
for important information.
There are several There are several
[documents for developers](Overview.md#developer-documentation). If [documents for developers](Overview.md#developer-documentation). If
you have questions on the code then you can also ask in the you have questions on the code then you can also ask in the
[Klipper Community Forum](#community-forum) or on the [Klipper Discourse Forum](#discourse-forum) or on the
[Klipper Community Discord](#discord-chat). [Klipper Discord Chat](#discord-chat).
## Klipper github
Klipper github may be used by contributors to share the status of
their work to improve Klipper. It is expected that the person opening
a github ticket is actively working on the given task and will be the
one performing all the work necessary to accomplish it. The Klipper
github is not used for requests, nor to report bugs, nor to ask
questions. Use the [Klipper Community Forum](#community-forum) or the
[Klipper Community Discord](#discord-chat) instead.

View File

@ -170,7 +170,7 @@ BOARD_ALIASES = {
If you need a new board definition and you are uncomfortable with the If you need a new board definition and you are uncomfortable with the
procedure outlined above it is recommended that you request one in procedure outlined above it is recommended that you request one in
the [Klipper Community Discord](Contact.md#discord). the [Klipper Discord](Contact.md).
## Flashing Boards that use SDIO ## Flashing Boards that use SDIO