PEP 1: Use plain text formatting and fix links

[hugovk]

Prep for PEP 676, which will give syntax highlighting. By default Python formatting is used:

https://python.github.io/peps/pep-0001/#pep-header-preamble

But we want plain text formatting here.

---

Also update some links to their newly redirected location.

And delete this one:

* `Frequently Asked Questions for Developers
  <http://docs.python.org/devguide/faq.html>`_

Because it redirects to 404 https://devguide.python.org/faq/

Checking the Internet Archive (https://web.archive.org/web/20120301112706/http://docs.python.org/devguide/faq.html#how-do-i-tell-who-is-and-isn-t-a-core-developer) I don't see a matching page on the new devguide?

[AA-Turner]

I think we need to discuss how to deal with updating code blocks for the correct 'highlighting type' across all PEPs -- or if we care. (If the default is Python, then perhaps updating e.g. C, text/plain, etc blocks is feasible)

A

[CAM-Gerlach]

A few minor suggestions related to links. Thanks!

[CAM-Gerlach]

Given you've updated the other links, may as well not still use a verbatim block that the user has to manually copy, paste and navigate to in their browser instead of simply a link. I suggest just deleting this block and making the change above instead to link it

[hugovk]

Thanks, like this? cb1fdfe

[CAM-Gerlach]

Sorry, I meant just deleting the whole block (couldn't make it a suggestion as it was outside the scope GitHub would let me), since the PEP repo is already referred to and directly linked two lines above, so restating that is now redundant.

[AA-Turner]

Thanks Hugo, looks good
A

[AA-Turner]

If we're changing this line, might as well update the capitalisation to be consistent.

Suggested change

	The Git repo for the peps is https://github.com/python/peps
	The Git repo for the PEPs is https://github.com/python/peps

[CAM-Gerlach]

Suggested change

The Git repo for the peps is https://github.com/python/peps

I suggest simply eliminating this line, since the PEP repo is already introduced and directly linked a couple lines above at this same URL.

[CAM-Gerlach]

I think we need to discuss how to deal with updating code blocks for the correct 'highlighting type' across all PEPs -- or if we care. (If the default is Python, then perhaps updating e.g. C, text/plain, etc blocks is feasible)

Good point. My intuition from reading a lot of PEPs is that the vast majority are Python, with a small but non-trivial fraction in C, and a handful in other languages; the number of plain-text verbatim blocks are likely somewhere between very small and modest. If desired, I could do a formal survey of a representative sample of PEPs; informally sampling single-line grep results, and a slightly less random sample of multi-line results, this conjecture seems to be generally supported.

While I don't want to create major churn on older PEPs, it should only affect a relatively small number of them (likely considerably fewer than #2209 ), and not making the change would be a display regression from the author's intent and the PEP's original rendering. Therefore, I'd suggest continuing to default to Python (which is the most sensible default here and minimizes work for authors) and just updating those PEPs (or at the very least, "active" PEPs). I could help take care of that

[AA-Turner]

Merged, thanks Hugo