docs icon indicating copy to clipboard operation
docs copied to clipboard

Building - Practice Exercise Docs: Clarify how append file is rendered

Open junedev opened this issue 3 years ago • 0 comments

This is regarding this section: https://exercism.org/docs/building/tracks/practice-exercises#h-file-docs-instructions-append-md

We had a lot of issues because people were not aware that the h1 header is removed and that the append content is rendered directly below the original instructions without any kind of separation. Usually you want to use an h2 after the h1 because of that so the content structure makes sense in end. Would be good to clarify how it works. Ideally with screenshots that illustrates it.

junedev avatar Sep 21 '22 19:09 junedev