exercism / exercism/dart

Make Test Driven Development More Prominent in Exercise Instructions

Open
#376 4 comments 0 reactions 0 assignees View on GitHub
Dominant language
Dart
Stars
60
Forks
97
PR merge metrics
No merged PRs in 30d

Description

Recently, we've had a few students confused that all but the first test is skipped. They were not aware of Exercism's approach to nudge them towards TDD. (See #375 #347)

For this track, I think we can add the instructions **and** reasoning for this approach more prominent. Correctly, the student would have to look fairly deeply into the track page to find any reference.

To find instructions, they would have to go to the main Dart Track page and look for a link at the bottom on the right-hand side. Click that link. Then from there, you can click on [Testing on the Dart Track](https://exercism.org/docs/tracks/dart/tests).

That's a pretty well obfuscated for new students to any track page.

What this track can do, would be to add a blurb about the reasoning **and** track-specific guidance on how to practice TDD with the API used in the `test` package.

Any other thoughts or ideas related to this from other @exercism/dart ?

@ErikSchierboom, @iHiD, @angelikatyborska have you seen other students for other tracks not understanding why all tests after the first were skipped?

@synaptiko had a suggestion for the exercism tool:
> maybe `exercism submit` command should report it to you (it should check that you don't have any skipped tests before the submit).

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.