From 6a35295712885b00fd09eb578aa0b862c6e917f2 Mon Sep 17 00:00:00 2001 From: Jeremy Walker Date: Fri, 24 Jan 2025 15:45:24 +0000 Subject: [PATCH 1/3] Remove instructions to open issues --- using/faqs.md | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/using/faqs.md b/using/faqs.md index 1c7748ae..cfb26c5b 100644 --- a/using/faqs.md +++ b/using/faqs.md @@ -77,7 +77,7 @@ The new site has a brand new command-line client, and also needs some extra meta Read about how to [upgrade your command-line client and migrate your solutions for the new site][upgrade-cli]. If that doesn't help, or you didn't use the old version of the command-line client, please read through the [command-line client Walkthrough][cli-walkthrough]. -If that doesn't help either, [open an issue][new-cli-issue] and we will help you get it sorted out. +If that doesn't help either, [please post on the forum][forum] and we will help you get it sorted out. ## How do I check the version of my command-line client? @@ -147,20 +147,16 @@ You can see more on the [How to Contribute page][contribute]. A new language track gets created when a member of the community takes the lead on it and becomes a maintainer of the track. If you'd like to get involved in helping set one up, there are [instructions here][new-language-request]. -## Opening an Issue +## Telling us when something is wrong -Before submitting an issue, be sure to check the relevant GitHub issue tracker to see if it has already been reported or resolved: +If you find something that's not wrong, please let us know by creating a thread on [the forum][forum]. -1. [The Exercism Website or Product][website-copy] -2. [The Command-Line Interface (CLI) Client][cli-client-issues] -3. [Exercises][languages] - Select your language and then look at the issues tab - -You can search through issues (remove the `is:open` filter to include closed/resolved issues). +Before creating a thread, be sure to check for existing discussions. Try a few different keywords. -## What if my issue is not listed here or in GitHub? +## What if my issue is not listed here or on the forum? -If your problem hasn't been resolved or reported, then create an issue in the appropriate repository by selecting the green **New issue** button. +If your problem hasn't been resolved or reported, then create a new [forum post][forum]. Make sure to include the following information: @@ -174,7 +170,7 @@ Make sure to include the following information: If your issue pertains to an exercise in your language track, then please find the correct language track [from this list][from-this-list] and submit an issue there. Please specify if the issue is with the instructions or something language specific, using the template below. -If you have spotted a typo or if you have a suggestion for clearer language or instructions on the general website, then [create an issue for Exercism Website Copy][website-copy-new-issue] with the following information: +If you have spotted a typo or if you have a suggestion for clearer language or instructions on the general website, then please create a new thread on [the forum][forum] with the following information: 1. Link to the page where the issue is 1. Explanation of what the mistake is or what is unclear @@ -197,7 +193,7 @@ If you have spotted a typo or if you have a suggestion for clearer language or i [learning-mode]: /docs/building/product/unlocking-exercises#h-learning-mode-vs-practice-mode [mail-abuse]: mailto:abuse@exercism.org?subject=%5BCoC%5D] -[new-cli-issue]: https://github.com/exercism/CLI/issues/new +[forum]: https://forum.exercism.org/ [new-language-request]: https://github.com/exercism/generic-track/blob/main/README.md [opening-an-issue]: #opening-an-issue [here-be-dragons]: https://www.youtube.com/watch?v=QAUHYzC9kFM @@ -208,4 +204,3 @@ If you have spotted a typo or if you have a suggestion for clearer language or i [unlocking-exercises]: /docs/building/product/unlocking-exercises [upgrade-cli]: https://github.com/exercism/website-copy/blob/main/pages/cli_v1_to_v2.md [website-copy]: https://github.com/exercism/website-copy/issues -[website-copy-new-issue]: https://github.com/exercism/website-copy/issues/new From d1a1f47b7ba646f22e44688b8cef893b567ed6b7 Mon Sep 17 00:00:00 2001 From: Jeremy Walker Date: Sun, 26 Jan 2025 20:55:37 +0000 Subject: [PATCH 2/3] Update using/faqs.md Co-authored-by: Anastasios Chatzialexiou <16361161+tasxatzial@users.noreply.github.com> --- using/faqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/using/faqs.md b/using/faqs.md index cfb26c5b..b5103fe9 100644 --- a/using/faqs.md +++ b/using/faqs.md @@ -149,7 +149,7 @@ If you'd like to get involved in helping set one up, there are [instructions her ## Telling us when something is wrong -If you find something that's not wrong, please let us know by creating a thread on [the forum][forum]. +If you find something that's wrong, please let us know by creating a thread on [the forum][forum]. Before creating a thread, be sure to check for existing discussions. Try a few different keywords. From 3b81b0ad028a309e10597612d443944bf86238a7 Mon Sep 17 00:00:00 2001 From: Glenn Jackman Date: Mon, 27 Jan 2025 08:50:45 -0500 Subject: [PATCH 3/3] Remove another reference to GitHub issues. As noticed by @tasxatzial --- using/faqs.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/using/faqs.md b/using/faqs.md index b5103fe9..76497e12 100644 --- a/using/faqs.md +++ b/using/faqs.md @@ -35,8 +35,7 @@ To learn more about what it means for the devil to be in the details, check out You're in luck. Here's a [step-by-step guide][getting-started] to get you started. -If something is still unclear for you or not working then it might be the same for others so we'd appreciate you letting us know. -Refer to [Opening an Issue][opening-an-issue] below for instructions on how you can help us help others. +If something is still unclear for you or not working then it might be the same for others so we'd appreciate you [letting us know on the forum][forum]. ## I get the error "Sorry, we could not authenticate you from GitHub" when trying to log in. What should I do?