sphinx-doc/sphinx

Autodoc should output generated rst

Open

#2,953 建立於 2016年9月13日

在 GitHub 查看
 (3 留言) (11 反應) (0 負責人)Python (1,985 fork)batch import
extensions:autodochelp wantedtype:proposal

倉庫指標

Star
 (5,625 star)
PR 合併指標
 (平均合併 10天 11小時) (30 天內合併 11 個 PR)

描述

When using autodoc or autosummary, the generated rst is never saved as far as I can tell. So if you go to a page that was generated with autosummary, like this: http://scikit-learn.org/dev/modules/generated/sklearn.cluster.DBSCAN.html#sklearn.cluster.DBSCAN

and you click "show this page's source" you'll just get the autosummary template: http://scikit-learn.org/dev/_sources/modules/generated/sklearn.cluster.DBSCAN.txt

That's not very helpful for debugging. I think storing the generated RST would be more helpful, possibly optionally?

貢獻者指南