I love the idea of mixing terminal and documentation, kind of like a terminal notebook. I wish there was an open source project that was basically just a shell/bash jupyter notebook and nothing more. So many little scripts, makefiles, project setups, etc. would be way easier to understand and maintain if they were mostly markdown documentation with some big "Run this" buttons next to the code blocks.