Skip to content

Commit 81b8406

Browse files
authored
Tweak documentation about opening issues (#415)
We don't want people to open issues on GitHub, we'd rather have them talk to us on the forum.
1 parent 985ab43 commit 81b8406

File tree

2 files changed

+39
-6
lines changed

2 files changed

+39
-6
lines changed

building/tracks/new/request-new.md

Lines changed: 38 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,52 @@
22

33
Please follow the instructions below to request a new Language Track.
44

5+
If you wish to request a new track, **you must post in the [Support category on the Exercism Community Forum][forum-support]** to discuss this with the team.
6+
7+
Before opening the post, it's worth considering:
8+
- Is it a programming language?
9+
- Does Exercism already support the language?
10+
- Has anyone else asked for it?
11+
- Will you be available to actively build and launch the track?
12+
13+
## Is it a programming language?
14+
15+
At Exercism we provide a learning platform for developers who want to practice a programming language or learn a new one.
16+
17+
If the language is a general purpose programming language, then we'll probably be interested in having the track on Exercism.
18+
We do not create tracks for tools, libraries, frameworks, or technologies.
19+
520
## Does Exercism already support the language?
621

7-
Please [check the list of track repositories](https://github.com/search?q=topic%3Aexercism-track+org%3Aexercism+fork%3Atrue&type=repositories) to find both active and inactive tracks.
22+
Please [check the list of track repositories][track-repositories] to find both active and inactive tracks.
823
If you find a repository for your language, check the `active` key's value in the repository's `config.json` file for its status:
924

10-
- `true`: the track is active and listed on the website's [tracks page](https://exercism.org/tracks).
11-
- `false`: the track is inactive and not listed on the website. The track still requires work for it to become active. If you would like to help out, please open an issue on that repository to say hello.
25+
- `true`: the track is active and listed on the website's [tracks page][exercism-tracks].
26+
- `false`: the track is inactive and not listed on the website.
27+
The track still requires work for it to become active.
28+
If you'd like to help out, please open an issue on that repository to say hello.
1229

1330
## Has someone else asked for it?
1431

15-
Do a search in the [issues of the exercism/request-new-language-track repository](https://github.com/exercism/request-new-language-track/issues) for the name of the language to see if the language was already requested.
32+
Do a search in the [issues of the generic-track repository][generic-track-repo] for the name of the language to see if the language was already requested.
1633
Remember to check both open and closed issues.
1734

35+
## Will you be available to actively build and launch the track?
36+
37+
Exercism is a not-for-profit organization, and all the language tracks are built by volunteers.
38+
We will only create a track if there is at least one volunteer who has offered to take the lead on building it.
39+
40+
The minimum to launch a track is:
41+
- 20 practice exercises (these can be based on specifications in the [problem-specifications][problem-specifications] repository.
42+
- Continuous integration that checks that the exercises can be solved.
43+
- A bit of configuration and documentation.
44+
45+
We are available to guide you along the way, and you can also get help from the community of folks who have done this for other languages.
46+
1847
## It doesn't exist - I want to create it!
1948

20-
Awesome!! Please open a [new issue](https://github.com/exercism/request-new-language-track/issues/new), filling out the template. We will take a look!
49+
Awesome!! Please create a new post in the [Exercism Forum][forum-support] so we can discuss the details.
50+
51+
[forum-support]: https://forum.exercism.org/c/support/8
52+
[generic-track-repo]: https://github.com/exercism/generic-track/issues
53+
[preblem-specifications]: https://github.com/exercism/problem-specifications

using/faqs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -191,7 +191,7 @@ If you have spotted a typo or if you have a suggestion for clearer language or i
191191

192192
[mail-abuse]: mailto:[email protected]?subject=%5BCoC%5D]
193193
[new-cli-issue]: https://github.com/exercism/CLI/issues/new
194-
[new-language-request]: https://github.com/exercism/request-new-language-track/blob/main/README.md
194+
[new-language-request]: https://github.com/exercism/generic-track/blob/main/README.md
195195
[opening-an-issue]: #opening-an-issue
196196
[overkill]: http://www.kytrinyx.com/talks/overkill
197197
[personal-settings]: https://exercism.org/my/settings/preferences/edit

0 commit comments

Comments
 (0)