Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove inconsistencies about getting help #396

Merged
merged 4 commits into from
Oct 25, 2022
Merged

Remove inconsistencies about getting help #396

merged 4 commits into from
Oct 25, 2022

Conversation

kytrinyx
Copy link
Member

@kytrinyx kytrinyx commented Oct 25, 2022

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.

With thanks to @ee7 for suggesting the improvements in #395

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.
@kytrinyx kytrinyx requested review from ee7 and iHiD October 25, 2022 07:19
Copy link
Member

@ee7 ee7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks.

building/tracks/shared-files.md Outdated Show resolved Hide resolved
building/tracks/shared-files.md Outdated Show resolved Hide resolved
kytrinyx and others added 3 commits October 25, 2022 10:56
Co-authored-by: ee7 <45465154+ee7@users.noreply.github.com>
Co-authored-by: ee7 <45465154+ee7@users.noreply.github.com>
This normalizes the reference to the Building Exercism
subcategory on the forum in markdown reference links.
@kytrinyx kytrinyx merged commit fba86ef into main Oct 25, 2022
@kytrinyx kytrinyx deleted the post-forum-tweaks branch October 25, 2022 09:17
ErikSchierboom pushed a commit to ErikSchierboom/docs that referenced this pull request Nov 22, 2022
* 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 <45465154+ee7@users.noreply.github.com>

* Use https in help doc example

Co-authored-by: ee7 <45465154+ee7@users.noreply.github.com>

* Normalize forum reference

This normalizes the reference to the Building Exercism
subcategory on the forum in markdown reference links.

Co-authored-by: ee7 <45465154+ee7@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants