My team has been experimenting with this -- using Jupyter notebooks to document processes while also providing the scripts to implement those processes. Jury's still out. We haven't been doing it for long enough to know all of the possible pitfalls and ways of making it work better.