-
Notifications
You must be signed in to change notification settings - Fork 163
Conversation
/format |
So if I summarize things to make sure I understand correctly, we have:
Is that correct? It's a little weird to me that there is all this juggling between the |
Correct.
This is not necessarily true. The exercise's introduction could have different information than the concept's introduction, but in the majority of the cases they will be identical. One reason for why they could be different is when you want to rewrite things a bit to better fit the exercise. As the two files will often have the same contents, we will be supporting a template for the exercise's introduction.md file that can refer to the concept's introduction: https://github.com/exercism/v3-docs/blob/master/anatomy/tracks/configlet/generating-documents.md#document-concept-exercises-introductionmd-file
This is correct. The
Well, it might seem weird from the viewpoint of Exercism v2, but in v3 concepts are separate, stand-alone entities that are viewable outside the context of an exercise. You could consider concepts to be more important than the actual concept exercises, as the latter serve just as the vehicle to teach concepts. Each concept will have its own, dedicated page, and its contents will depend on whether the student has completed the exercise teaching that concept. If so, the We'll also allow linking to concepts, which could e.g. be very convenient for mentors. |
Thanks! |
Alright, in practice, for our basics concept we end up with 3 identical files but I guess that's mainly because it's the basics one. We might better differentiate those for subsequent concepts. |
That's indeed quite likely. One way in which the |
We've recently specified that each concept should have its own
introduction.md
file: https://github.com/exercism/v3-docs/blob/master/anatomy/tracks/concepts.md#file-introductionmd.This PR tries to automatically add these
introduction.md
files for each of the concept of your track. It does that as follows:See #2975