[issue16544] Add external link to ast docs

Senthil Kumaran added the comment: Thanks for patch and the work on Green Tree Snakes, Thomas. It is a great resource. I agree that a lot could be included directly in stdlib docs, but till then, as suggested/recommended by Andrew and Ezio, a see also link is a good addition. --

[issue16544] Add external link to ast docs

Roundup Robot added the comment: New changeset 94b0e5e9b6e8 by Senthil Kumaran in branch '3.4': Issue16544 - Add a link to an external documentation resource in ast module docs. https://hg.python.org/cpython/rev/94b0e5e9b6e8 New changeset ebf164b07be1 by Senthil Kumaran in branch '3.5': merge

[issue16544] Add external link to ast docs

Changes by Ezio Melotti : -- assignee: docs@python -> ezio.melotti versions: +Python 3.6 -Python 3.3, Python 3.4 ___ Python tracker

[issue16544] Add external link to ast docs

Carol Willing added the comment: Matthias, I've added you to the nosy list for this ast doc enhancements issue. Reference: msg243484 on Issue 24220. -- nosy: +mbussonn, willingc versions: +Python 3.5 ___ Python tracker rep...@bugs.python.org

[issue16544] Add external link to ast docs

Changes by Berker Peksag berker.pek...@gmail.com: -- nosy: +berker.peksag ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16544 ___ ___

[issue16544] Add external link to ast docs

Thomas Kluyver added the comment: Here's a simple patch that links to Green Tree Snakes from the ast module docs, using the 'sidebar' directive (that's what the logging module uses to link to tutorials, which seemed analogous). I'm still happy to contribute these docs to CPython if people

[issue16544] Add external link to ast docs

Thomas Kluyver added the comment: Thanks, I'm really glad to see that it's useful to others. I don't mind contributing it to Python, but I wonder if it's better to let it develop separately for a few months first - it's still very new, and I can improve it faster in a repository where I can

[issue16544] Add external link to ast docs

Ezio Melotti added the comment: I don't mind contributing it to Python, but I wonder if it's better to let it develop separately for a few months first - it's still very new, and I can improve it faster in a repository where I can commit to it myself. That's fine, there's no hurry to

[issue16544] Add external link to ast docs

Thomas Kluyver added the comment: I think that putting the full content of GTS into the ast module docs would make it awkwardly long. Perhaps the bulk of it could become a howto, and GTS could be maintained separately as a showcase of examples. --

[issue16544] Add external link to ast docs

New submission from Andrew Svetlov: http://greentreesnakes.readthedocs.org/en/latest/index.html is excellent and comprehensive documentation for ast tree structures. It would be nice to incorporate that docs into stdlib documentation, but adding *see also* section is good enoigh as first step.

[issue16544] Add external link to ast docs

Ezio Melotti added the comment: I would suggest to contact the author and ask him if he wants to contribute those docs to Python. They could be then be merged to the current docs or included as a separate HOWTO. -- nosy: +ezio.melotti type: - enhancement

[issue16544] Add external link to ast docs

Andrew Svetlov added the comment: I've done it just now sending him message via bitbucket. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16544 ___