It would be great if we provided a link from a documentation page back to the source file that the page is produced from, e.g. have https://docs.python.org/3.6/library/abc.html provide a link to https://github.com/python/cpython/blob/3.6/Doc/library/abc.rst.

On the left menu, there's already a Show Source link. 
Is the idea to replace that link to github.com/python/cpython/blob/.... ?

Or, are you thinking about adding a new link under the main heading, similar to 
**Source code:** :source:`Lib/abc.py` 
but for the docs, so maybe by creating a new role like:
**Docs Source code:** :docs_source:`Doc/library/abc.rst`

Either idea works, but I want a link that someone who finds a spelling mistake can easily follow and submit a PR to fix the issue.

Thanks, Brett :) I think it's easier to update the existing Source Link to github. I'll work on a patch for this.

Hi,
This patch updates the Show Source link on the left of Docs menu and point it to github.
I tested it locally, and works for versions >= 3.5 
Please let me know if you have any feedback about this.
Thanks :)

Not sure if the older docs versions should be updated too? In that case, I'll need to prepare different patches for 3.4, 3.3 and 2.7

Thanks for the patch, Mariatta! Once we have migrated to GitHub we can apply the patch (don't let me forget :) ).

Any version still under active maintenance should probably be updated, so that would probably mean 2.7 but not the other versions.

Thanks, Brett.

Here's the patch that will work for the 2.7 branch.

Nice idea.  I agree with an updated sidebar link, both aesthetically and as a practical matter for doc maintainers.

Now that we have migrated to GitHub and Mariatta is a core dev I'm assigning this to her. :)

Thanks all :)
PRs have been merged on GitHub.
Closing this.

New changeset 23d2c31cbf3032b8c6bb254f06c4532a6db466b6 by Mariatta in branch '2.7':
[2.7] bpo-28929: Add to Misc/NEWS (GH-286)
https://github.com/python/cpython/commit/23d2c31cbf3032b8c6bb254f06c4532a6db466b6

New changeset 5023686f7ee69e9da07cda4b7da6691f19892111 by Mariatta in branch '3.5':
[3.5] bpo-28929: Add to Misc/NEWS (GH-285)
https://github.com/python/cpython/commit/5023686f7ee69e9da07cda4b7da6691f19892111

New changeset 1a8dd944d4016593e78a7a6c3c635adee783abfd by Mariatta in branch '3.6':
[3.6] bpo-28929: Add to Misc/NEWS (GH-284)
https://github.com/python/cpython/commit/1a8dd944d4016593e78a7a6c3c635adee783abfd

New changeset e3bf4cdd3db9004220d3ec7f5db4e7d16a99c743 by Mariatta in branch 'master':
bpo-28929: Add to Misc/NEWS (GH-112)
https://github.com/python/cpython/commit/e3bf4cdd3db9004220d3ec7f5db4e7d16a99c743

New changeset f66c81ff499fb431e56bc68f5e39c2f7b9fcb6a7 by Mariatta in branch '3.6':
[backport to 3.6] bpo-28929: Link the documentation to its source file on GitHub (#37)
https://github.com/python/cpython/commit/f66c81ff499fb431e56bc68f5e39c2f7b9fcb6a7

New changeset d4a97d894859d4bb52937d46460049ba016e00b2 by Mariatta in branch 'master':
bpo-28929: Link the documentation to its source file on GitHub (#35)
https://github.com/python/cpython/commit/d4a97d894859d4bb52937d46460049ba016e00b2

New changeset e15259c2dfef58df5f7cfa2305811a00c05e0353 by Mariatta in branch '2.7':
bpo-28929: Link the documentation to its source file on GitHub (#38)
https://github.com/python/cpython/commit/e15259c2dfef58df5f7cfa2305811a00c05e0353

New changeset cabd1c7462ef991937e0e759b9bf307b3091ef06 by Mariatta in branch '3.5':
[backport to 3.5] bpo-28929: Link the documentation to its source file on GitHub (#36)
https://github.com/python/cpython/commit/cabd1c7462ef991937e0e759b9bf307b3091ef06