Skip to content

Commit fba86ef

Browse files
kytrinyxee7
andauthored
Remove inconsistencies about getting help (#396)
* Remove inconsistencies about getting help We references to the unofficial Exercism help channels on Gitter with references to the new official Exercism forum. In a couple of places this introduced inconsistencies. The first is a sample `help.md` file, where instead of linking to the Gitter channel we referenced a language- specific sub-channel on the forum. However this was in a document where we discourage links to Exercism-wide resources, which will already be included in the docs seen by the end-user. The second is the name of a markdown link-reference. We were linking to the Building Exercism sub-channel, but called the link-reference 'forum'. Elsewhere, 'forum' links to the top-level forum, and we've called the reference 'building-exercism' when linking to this category. This fixes these inconsistencies. * Use subreddit instead of channel in help doc example Co-authored-by: ee7 <[email protected]> * Use https in help doc example Co-authored-by: ee7 <[email protected]> * Normalize forum reference This normalizes the reference to the Building Exercism subcategory on the forum in markdown reference links. Co-authored-by: ee7 <[email protected]>
1 parent 9614963 commit fba86ef

File tree

4 files changed

+13
-7
lines changed

4 files changed

+13
-7
lines changed

building/tooling/analyzers/creating-from-scratch.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ These are the steps to get going:
99
3. Open an issue at [exercism/exercism][exercism-repo] introducing yourself and telling us which language you'd like to create a Analyzer for.
1010
4. Once an Analyzer repo has been created, use [the Analyzer interface document](/docs/building/tooling/analyzers/interface) to help guide your implementation.
1111

12-
We have an incredibly friendly and supportive community who will be happy to help you as you work through this! If you get stuck, please start a new topic on [the Exercism forum][forum] or create new issues at [exercism/exercism][exercism-repo] as needed 🙂
12+
We have an incredibly friendly and supportive community who will be happy to help you as you work through this! If you get stuck, please start a new topic on [the Exercism forum][building-exercism] or create new issues at [exercism/exercism][exercism-repo] as needed 🙂
1313

14-
[forum]: https://forum.exercism.org/c/exercism/building-exercism/125
14+
[building-exercism]: https://forum.exercism.org/c/exercism/building-exercism/125
1515
[exercism-repo]: https://github.com/exercism/exercism

building/tooling/representers/creating-from-scratch.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ These are the steps to get going:
99
3. Open an issue at [exercism/exercism][exercism-repo] introducing yourself and telling us which language you'd like to create a Representer for.
1010
4. Once a Representer repo has been created, use [the Representer interface document](/docs/building/tooling/representers/interface) to help guide your implementation.
1111

12-
We have an incredibly friendly and supportive community who will be happy to help you as you work through this! If you get stuck, please start a new topic on [the Exercism forum][forum] or create new issues at [exercism/exercism][exercism-repo] as needed 🙂
12+
We have an incredibly friendly and supportive community who will be happy to help you as you work through this! If you get stuck, please start a new topic on [the Exercism forum][building-exercism] or create new issues at [exercism/exercism][exercism-repo] as needed 🙂
1313

14-
[forum]: https://forum.exercism.org/c/exercism/building-exercism/125
14+
[building-exercism]: https://forum.exercism.org/c/exercism/building-exercism/125
1515
[exercism-repo]: https://github.com/exercism/exercism

building/tooling/test-runners/creating-from-scratch.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ These are the steps to get going:
99
3. Open an issue at [exercism/exercism][exercism-repo] introducing yourself and telling us which language you'd like to create a Test Runner for.
1010
4. Once a Test Runner repo has been created, use [the Test Runner interface document](/docs/building/tooling/test-runners/interface) to help guide your implementation. There is a [generic test runner repository template](https://github.com/exercism/generic-test-runner/) that you can use to kick-start development.
1111

12-
We have an incredibly friendly and supportive community who will be happy to help you as you work through this! If you get stuck, please start a new topic on [the Exercism forum][forum] or create new issues at [exercism/exercism][exercism-repo] as needed 🙂
12+
We have an incredibly friendly and supportive community who will be happy to help you as you work through this! If you get stuck, please start a new topic on [the Exercism forum][building-exercism] or create new issues at [exercism/exercism][exercism-repo] as needed 🙂
1313

14-
[forum]: https://forum.exercism.org/c/exercism/building-exercism/125
14+
[building-exercism]: https://forum.exercism.org/c/exercism/building-exercism/125
1515
[exercism-repo]: https://github.com/exercism/exercism

building/tracks/shared-files.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,13 @@ This document should **not** link to Exercism-wide (track-agnostic) help resourc
5656
```markdown
5757
# Help
5858

59-
If you're having trouble, feel free to ask help in the programming category of [the Exercism forum](https://forum.exercism.org/c/programming/5).
59+
To get help if you're having trouble, you can use one of the following resources:
60+
61+
- [Kotlin Documentation](https://kotlinlang.org/docs/reference/)
62+
- [Kotlin Forums](https://discuss.kotlinlang.org/)
63+
- [Kotlin Slack Channel](https://kotlinlang.slack.com/): [get invite here](https://slack.kotlinlang.org/)
64+
- [Stack Overflow](https://stackoverflow.com/questions/tagged/kotlin)
65+
- [Kotlin Subreddit](https://www.reddit.com/r/kotlin)
6066
```
6167

6268
## File: `representations.md`

0 commit comments

Comments
 (0)