Rename Doc/README.txt to Doc/README.rst and add formatting #104
Conversation
ghost
mentioned this pull request
ghost
changed the title
Doc/README.rst
Outdated
| both style and markup, is available in the "Documenting Python" chapter of the | ||
| developers guide <https://docs.python.org/devguide/documenting.html>. | ||
| both style and markup, is available in the "`Documenting Python <https://docs.python.org/devguide/documenting.html>`_" chapter of the | ||
| developers guide. |
There was a problem hiding this comment.
folding long line is preferred.
|
@methane That line is now folded. |
|
Has anyone tested to make sure the docs build doesn't pick up and build README.rst? I'm not sure that it would be harmful, but would be unnecessary. |
|
@zware nice catch! @rogersachan There are two problem.
(I feel markdown is better for README now. But I was too late.) |
|
@methane I have made the requested changes. |
Doc/README.rst
Outdated
| Bugs in the toolset should be reported in the Sphinx bug tracker at | ||
| https://www.bitbucket.org/birkenfeld/sphinx/issues/. | ||
| Bugs in the toolset should be reported in the | ||
| `Sphinx bug tracker <https://www.bitbucket.org/birkenfeld/sphinx/issues/>`_. |
There was a problem hiding this comment.
This link is outdated, it's now https://github.com/sphinx-doc/sphinx/issues
|
@Haypo I have made the requested changes. |
vstinner
dismissed
methane’s stale review
"methane: @rogersachan There are two problem." these issues have been fixed
|
Thanks, I merged your PR. Right now http://sphinx-doc.org/ link displays "Diese Präsenz ist leider nicht verfügbar." error message in german, whereas http://www.sphinx-doc.org/ redirects to http://www.sphinx-doc.org/en/stable/ which is the expected website. But I hope that the error is only temporary. Otherwise, we can fix that later. I reported this issue on IRC. |
|
The Windows installer build picks up this readme file and distributes it as I vote we should keep both so that we can distribute the file without rst formatting. (As an aside, we also read the /LICENSE file, so if someone wants to come in and "fix" that too then they'll also need to update the installer.) |
This issue is about Doc/README.txt, but Tools/msi/exe/exe_files.wxs seems to refer to README.txt (root directory). See PR #2 which renamed README.txt to README.rst. This PR was followed by PR #70, PR #73 and #21. Is it common to provide README as plain text on Windows? Would it be possible to provide a README formatted as HTML? It would look nicer than plain text, no? It would also allow to keep new features like images (well, "badges"). For example, on Linux I'm running manually "rst2html README.rst README.html". |
|
Ah, I see. This PR just modified the one at the root, which is why it showed up as the last commit for the file. It doesn't matter whether it's common or not - it's a functional change that should have been on bpo and signed off by the RMs (who are responsible for keeping at least the header in the file up to date). This may just be Ned, depending on where the change was backported to. |
|
I opened http://bugs.python.org/issue29579 |
…honGH-104) (cherry picked from commit b3f1f59)
…itialisation Initialise slp_initial_tstate early, as in Stackless 2.7. https://bitbucket.org/stackless-dev/stackless/issues/104
|
Thanks @rogersachan for the PR, and @Haypo for merging it 🌮🎉.. I'm working now to backport this PR to: 2.7. |
|
Sorry, @rogersachan and @Haypo, I could not cleanly backport this to |
|
I don't think that we need to backport this change to Python 2.7, so I removed the "needs backport to 2.7". |
I have simply updated the document and its references to README.rst (thanks to whoever formatted it).