Make Test Driven Development More Prominent in Exercise Instructions about dart HOT 4 OPEN

My two cents as a fresh student on Exercism tool. When I started the track, I saw something like this:

But the page where the skipped tests are described is hidden under a very generic link. I somehow thought it's a link to the official Dart documentation which I already had opened.

For each exercise I was reading both README.md and HELP.md files, that's where I would expect this kind of instructions.

And as Stargator mentioned above, I think exercism submit would be great place for some report of how many tests are passing/skipped/failing etc. and that in order to complete the exercise you are supposed to have all of them passing.

from dart.

@synaptiko Thanks. This thread is just for discussion about the Dart track. For the exercism tool, an issue would have to be created at exercism/cli.

It would be a tough thing to sell, since that may require the exercism tool to know the syntax of all the languages on exercism.

from dart.

(cc @taiyab - maybe we add links to all the docs here rather than just to the docs section?)

from dart.

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

Yeah, this happens from time to time. Tracks have different "solutions" to this, including adding information to the shared tests (see this example), and other tracks have some comments added to their implementation or test files.

from dart.