Feature: Automatically run example code in a REPL about standard-readme HOT 6 CLOSED

There is run-markdown That does something similar. In its current state it is not well usable because you can't prepare an environment for the test. (specify code that you don't need to be visible within the markdown file). But I think think in general it is good practise - I don't know how often I published broken docs ...

from standard-readme.

This would have to be a suggestion, as some code can't easily be run in a REPL. We could suggest run-markdown. Or others?

from standard-readme.

If there is a linter, it should include a way to pass the code snippets to an executor: i.e. if there is a

console.log('Hello')

and you run the readme against standard-readme --exec="npm run test-doc"

and it will execute the above snippet like:

$ echo "console.log('Hello')" | npm run test-doc -- 1

from standard-readme.

Agreed about this is something that ought to be worked into the linter. Going to link it to #5 and leave this open for now.

from standard-readme.

Is this something standard-readme can dictate? 🤔 I’d leave this up to platforms that render readmes!

from standard-readme.

Agreed.

from standard-readme.