Thanks for this! I want to check the WEB-inspired approaches at some point, this is super useful.
The Markdown one seems interesting too.
I'll probably stick with this for stuff where there's some expectation of drive-by contributions (the tutorial has seen a bunch, it was one of the motivations behind this) because requiring additional tooling can often be a bar that's too high.
Agreed on the general literate programming note. I'm not sure I'll ever pick it up for something that doesn't have an obvious accompanying article/book to come with it, but if I ever write another tutorial or something, I'll definitely use it from the beginning.
But knowing what's out there is definitely important (and AsciiDoctor is extensible so these things could probably be added as plugins).
The Markdown one seems interesting too.
I'll probably stick with this for stuff where there's some expectation of drive-by contributions (the tutorial has seen a bunch, it was one of the motivations behind this) because requiring additional tooling can often be a bar that's too high.
Agreed on the general literate programming note. I'm not sure I'll ever pick it up for something that doesn't have an obvious accompanying article/book to come with it, but if I ever write another tutorial or something, I'll definitely use it from the beginning.
But knowing what's out there is definitely important (and AsciiDoctor is extensible so these things could probably be added as plugins).