You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: reference/implementing-a-concept-exercise.md
+13-1Lines changed: 13 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,14 @@
1
1
# How to implement a Python concept exercise
2
2
3
-
This document describes the steps required to implement a concept exercise for the Python track. As this document is generic, the following placeholders are used:
3
+
This document describes the steps required to implement a concept exercise for the Python track.
4
+
5
+
**Please please please read the docs before starting.** Posting PRs without reading these docs will be a lot more frustrating for you during the review cycle, and exhaust Exercism's maintainers' time. So, before diving into the implementation, please read the following documents:
6
+
7
+
-[The features of v3][docs-features-of-v3].
8
+
-[Rationale for v3][docs-rationale-for-v3].
9
+
-[What are concept exercise and how they are structured?][docs-concept-exercises]
10
+
11
+
As this document is generic, the following placeholders are used:
4
12
5
13
-`<SLUG>`: the name of the exercise in kebab-case (e.g. `anonymous-methods`).
6
14
-`<NAME>`: the name of the exercise in snake_case (e.g. `anonymous_methods`).
@@ -43,6 +51,7 @@ languages
43
51
## Step 1: add track-specific files
44
52
45
53
These are files specific to the Python track:
54
+
46
55
-`src/<NAME>.py`: the stub implementation file, which is the starting point for students to work on the exercise.
47
56
-`test/<NAME>_test.py`: the test suite.
48
57
-`.meta/example.py`: an example implementation that passes all the tests.
@@ -57,3 +66,6 @@ When implementing an exercise, it can be very useful to look at already implemen
0 commit comments