For general explanatory or exploratory articles/documents I agree. I write all my notes in Org mode together with `ntangle`.
Two examples: * the recipes in the `ggplotnim` repository are just a literate programming document: <https://github.com/Vindaar/ggplotnim/blob/master/recipes.org> * an excerpt of my work notes exploring some computations with code: <https://github.com/Vindaar/TimepixAnalysis/blob/master/Doc/other/axionWithGasPhase.org> But for the purpose of what the `getting-started` repository is trying to do, I think `nimib` is a great fit. Not only is it only using Nim tools instead of relying outside tooling, but more importantly: the point is helping people get into Nim for scientific computing. So by definition the code _is_ the priority.