walkthru

This is part of a set of tools designed to verify that code walkthroughs work correctly. The need arised when I wrote a step by step code walkthrough. I created the instructions based on a finished repository, but it was hard to verify that all the steps worked correctly. I could also have missed some steps, but I would need to follow all instructions step by step to make sure they work fine.

Usage no npm install needed!

<script type="module">
  import walkthru from 'https://cdn.skypack.dev/walkthru';
</script>

README

Walkthru

This is part of a set of tools designed to verify that code walkthroughs work correctly. The need arised when I wrote a step by step code walkthrough. I created the instructions based on a finished repository, but it was hard to verify that all the steps worked correctly. I could also have missed some steps, but I would need to follow all instructions step by step to make sure they work fine.

Walkthru solves this problem. It lets you verify that all steps in a markdown file work correctly. It transforms shell commands and code snippets from a markdown file into a shell script. To verify that your walkthrough is correct, you just need to run walkthru input.md output.sh and run the generated shell script.

Note that by itself, walkthru is just a tool that generates a shell script based on commands in a markdown file. It's entirely up to you to write the commands in a way that lets you verify that they work correctly. I recommend that you run your script in a Docker container so that it starts from scratch every time. You can see an example in fixtures folder. To try it out, run ./shell.sh to start a shell session in the container. Then run ./walkthrough.sh inside it, wait for it to finish, and finally go to http://localhost:3000. You should see the final step of the walkthrugh working.

 Installation

yarn global add walkthru or npm install -g walkthru

 Usage

walkthru input.md output.sh