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

Extract track-specific help instructions from config/exercise_readme.go.tmpl #58

Closed
ErikSchierboom opened this issue Jul 14, 2021 · 14 comments
Assignees
Labels
x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:size/tiny Tiny amount of work x:type/docs Work on Documentation

Comments

@ErikSchierboom
Copy link
Member

Each track needs a file that contains track-specific instructions on how to get help. The contents of this document are only presented to the student when using the CLI. This file lives at exercises/shared/.docs/help.md. You almost certainly already have this information, but need to move it to the correct place.

For v2 tracks, this information was (usually) included in the readme template found at config/exercise_readme.go.tmpl. As such, tracks can extract the help instructions from the config/exercise_readme.go.tmpl file to the exercises/shared/.docs/help.md file.

See https://github.com/exercism/csharp/pull/1557/files for an example PR.

Tracking

exercism/v3-launch#50

@ErikSchierboom ErikSchierboom added x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:size/tiny Tiny amount of work x:type/docs Work on Documentation labels Aug 18, 2021
@hsadia538
Copy link
Contributor

Can I get assigned here @ErikSchierboom

@ErikSchierboom
Copy link
Member Author

Sure!

@hsadia538
Copy link
Contributor

@ErikSchierboom the current
config/exercise_readme.go.tmpl does not seem to have help instructions.
Also, Should I create the directory excercises/shared/.docs as no such exists as of now?

@ErikSchierboom
Copy link
Member Author

@hsadia538 Yes, and it should have two files: help.md and tests.md. See the documentation for guidance on what the contents of those files should be.

@lpil
Copy link
Member

lpil commented Jun 16, 2022

Thank you @hsadia538 !

@hsadia538
Copy link
Contributor

@ErikSchierboom
do we have a gitter channel or forum for gleam?
also I was unable to find the exercise track for gleam, why is that so?

@ErikSchierboom
Copy link
Member Author

@hsadia538 I don't know of a specific gitter channel. If you email me at erik @ exercism.org, I can give you access to the Exercism slack.

As for which the Gleam track is not on Exercism yet, that is because it is not done. #32 contains a list of the things that need to happen for it to become active. Are you interested in getting the Gleam track launched?

@hsadia538
Copy link
Contributor

hsadia538 commented Jun 17, 2022

Yes, I am interested in doing so.
I have dropped you an email as well.

I was asking about the gitter channel as I was unsure as to what should I add in help.md and tests.md
@ErikSchierboom

@ErikSchierboom
Copy link
Member Author

I was asking about the gitter channel as I was unsure as to what should I add in help.md and tests.md

  • The tests.md file should contain a concise description on how to run the tests
  • The help.md file should link to any track-specific resources that could be useful to the student when trying to fix errors

See https://github.com/exercism/csharp/blob/main/exercises/shared/.docs/tests.md and https://github.com/exercism/csharp/blob/main/exercises/shared/.docs/help.md for examples.

@hsadia538
Copy link
Contributor

hsadia538 commented Jun 30, 2022

I was unable to find much on gleam and I haven't gotten a chance to work on it before hence the questions.
Another query is on running the test? the above example says
You can run the tests by opening a command prompt in the exercise's directory, and then running the [dotnet test command](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-test) Alternatively, most IDE's have built-in support for running tests, including [Visual Studio](https://docs.microsoft.com/en-us/visualstudio/test/run-unit-tests-with-test-explorer), [Rider](https://www.jetbrains.com/help/rider/Unit_Testing_in_Solution.html) and [Visual Studio code](https://github.com/OmniSharp/omnisharp-vscode/wiki/How-to-run-and-debug-unit-tests). See the [tests page](https://exercism.org/docs/tracks/csharp/tests) for more information. Skipped tests Initially, only the first test will be enabled. This is to encourage you to solve the exercise one step at a time. Once you get the first test passing, remove the Skip property from the next test and work on getting that test passing.

Would something like the same apply to gleam? The track isn't up and running so I haven't gotten a chance to see and run tests.

@lpil
Copy link
Member

lpil commented Jun 30, 2022

Hey @hsadia538 ! I can help with any specific questions around Gleam.

For that one I think we could have something like this:

You can run the tests by opening the terminal in the exercise's directory, and then running gleam test.

The gleeunit test framework doesn't offer a way to skip tests at the moment so I think we would have to have them all enabled, at least for now.

Thank you again for your help here 💜

@hsadia538
Copy link
Contributor

Alright, thanks a lot I will create a PR shortly on this.

@giacomocavalieri
Copy link
Contributor

@lpil this seem to have been fixed by #83, so maybe we could close it? Or is there anything missing?

@lpil
Copy link
Member

lpil commented Jun 1, 2023

I think so! Thank you

@lpil lpil closed this as completed Jun 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:size/tiny Tiny amount of work x:type/docs Work on Documentation
Projects
None yet
Development

No branches or pull requests

4 participants