exercism / exercism/docs

General documentation about practice exercises

Open
#409 0 comments 2 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
52
Forks
98
PR merge metrics
No merged PRs in 30d

Description

It came up in https://github.com/exercism/problem-specifications/pull/2149#pullrequestreview-1178116799 and other conversations that we are currently missing documentation/explanation/rationale on practice exercises in general, e.g.

> What makes a good practice exercise? It what ways should they challenge the student? Do we want to leave some ambiguity in the descriptions to make it more like real life or should descriptions always be as clear as possible? What are the criteria for adding a new exercise to problem spec or a track?

The above applies to the maintainer side. Additionally, we might also miss more documentation/tutorials around how to deal with practice exercises as a student (e.g. TDD, you need to select the concept to use on your own, potentially try different ones, etc.).

Sidenote: For learning exercises there is a bit more written down I think but there might be more needed as well.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.