GitChapter

https://github.com/chrissound/GitChapter Hello! This is a project I've written on the side for the past year or two. Thought it may be time to perhaps share the project! Essentially I got tired of writing programming blog posts, that were error prone and tedious to copy / past commands. I also got tired of trying to learn from programming posts written by others, and having to setup all the necessary files from scratch. GitChapter (as a user/reader) ultimately allows you to checkout a programming tutorial/blog post directly at a specific "chapter", and being able to hack right away from that point. An example of a "gitchapter" project / repo written is: https://github.com/chrissound/GentleIntroductionToMonadTransformers

You should take a look at embedmd, which allows you to include files (or just portions of a file) in a Markdown file: https://github.com/campoy/embedmd As I wrote in the post, I didn't use it because it doesn't allow me to include a portion of something and then comment out a part of that, but today I got thinking: if it could include a portion of a function and also the relevant (semantic?) context, it would be 99% of what I need. But the "relevant context" is the tricky part, I guess. I like what git diff does, when it shows the signature of a changed function (does it simply use the first of the previous lines that are less intended?), but I guess it's hard to get really right... edit: GitChapter is also a really interesting project. If it didn't use a real git repository, but something like folders that resemble single commits, I thin

You mentioned writing a tutorial and being able to execute the result, so thought I'd mention a project I'm working on to do exactly this. It started when I got annoyed with how difficult it was to write a 'code' tutorial. Essentially it allows you commit a markdown file (or any other format) alongside your source code and you can embed source code snippets / shell commands into this file - which then gets rendered into the main 'output' (the tutorial / article). https://github.com/chrissound/GitChapter