Practice Exercise spec mentions problem-specification introduction file - none exist.

[verdammelt]

The practice exercise spec mentions that .docs/introductions.md is required if the problem specification has a introductions.md file. But it does not look like any problem specification exercise has such a file.

It appears in my track that the .docs/introduction.md file was derived from the problem specification exercises' description.md. Should this reference to introduction.md in problem specification be replaced with a reference to description.md?

[verdammelt]

I can put in a PR to fix this if someone can confirm the reference is incorrect.

[verdammelt]

Closing this issue - I believe I was confused between 'introduction' and 'instruction'. I see that instruction file is defined to be derived from the problem specifiation description file.

Sorry for the noise.

[iHiD]

@verdammelt Good spot. The aim is to migrate all problem specs from a single description.md file to introduction.md and instructions.md. However, we don't want anything blocked by this, so we're respecting description.md for now, and then also intro/instructions when they're done.

We decided not to rename the description.md to instructions.md as having them with the old name allows us to see which have been migrated over and which haven't.

See also https://github.com/exercism/go/pull/1414/files#r574656719 (which I'd like to discuss on today's call).

If there is somewhere we could update the docs in this repo to make all that i've just written clear(er) or fix bits that don't mention it, I'd appreciate the PR for that! :)

[iHiD]

Sorry for the noise.

@verdammelt Not noise! Let's get it clarified better in the docs :)