将Python脚本传递给主管的最简单方法是什么？

Question

我完成了我的第一次草稿计算，并想知道如何最有效地将代码传递给非Python用户。我在考虑一个HTML或PDF文件（可能是 jupyter notebook 样式），它允许用它的渲染输出整齐地显示代码，以及一些文本来彻底解释所做的事情在每一步。我看到 Markdown 似乎是一个用于此目的的包，但在我阅读特定于包的语法之前，我想知道是否有更简单的方法。

Answer 1

看一下Sphinx：http://www.sphinx-doc.org/en/master/

这是一个库，可让您为项目生成专业的文档。我自己用它来向管理层提出我的想法/代码。结果看起来非常专业，而且非常易于使用。我会避免Markdown。狮身人面像看起来好多了。