Convert text-based PEPs to reST

[brettcannon]

Not really important, but it does unify things.

[Carreau]

Stupid existential question, should pep-9 (Sample Plaintext PEP Template) be converted to rst ?

[Rosuav]

Haha, good question. Maybe keep it as text and identify it as deprecated?

[Carreau]

Haha, good question. Maybe keep it as text and identify it as deprecated?

It is already. But if not converted, that would make it trickier to automatize the Sphinx build process.

One possibility is to put the all content of the pep in code block. Indented by 4 spaces, and add an warning on top.

[brettcannon]

That's a possibility. I would leave that PEP for last for conversion as it's obviously the least important one to convert.

[brettcannon]

#142, #143, #144, and #148 are conversions from text to reST.

[Mariatta]

Not including PEP 9, there are 133 more PEPs still in plain text :P

[gvanrossum]

So my strategy would be to take each next conversion as an opportunity to refine your conversion script. After 33 improvements the rest should not need manual tweaking.

[brettcannon]

Once you're comfortable that your script isn't going to break anything, @Mariatta , then I would be fine with one big PR or batches of PRs that converts several of the text-only PEPs at once. We have version control for a reason. 😄

[Carreau]

For the few peps I made into rst I used this, if it can be of help. I found that a couple of peps/peps author were using different style and the you regularly need to make manual check/fixes after auto transform.

[brettcannon]

I just ran grep -i -L "^Content-Type: text/x-rst" *.txt over repo and this is what I got:

pep-0000.txt
pep-0009.txt
pep-0100.txt
pep-0101.txt
pep-0102.txt
pep-0205.txt
pep-0207.txt
pep-0209.txt
pep-0214.txt
pep-0225.txt
pep-0227.txt
pep-0230.txt
pep-0231.txt
pep-0234.txt
pep-0242.txt
pep-0245.txt
pep-0246.txt
pep-0252.txt
pep-0253.txt
pep-0255.txt
pep-0262.txt
pep-0275.txt
pep-0276.txt
pep-0280.txt
pep-0282.txt
pep-0285.txt
pep-0293.txt
pep-0296.txt
pep-0308.txt
pep-0319.txt
pep-0323.txt
pep-0324.txt
pep-0340.txt
pep-0343.txt
pep-0354.txt
pep-0355.txt
pep-0363.txt
pep-0371.txt
pep-0397.txt
pep-0450.txt
pep-0452.txt
pep-3101.txt
pep-3143.txt
pep-3148.txt

That's 44 PEPs left to convert (although PEP 0 is auto-generated so that's a bit different than the rest).

[mozillazg]

All done! 🎇🎉

$ grep -i -L "^Content-Type: \+text/x-rst" *.txt
pep-0009.txt

[gvanrossum]

Whee! Now we can rename all .txt files to .rst, and remove a bunch of stuff from pep2html.py. Right?

[Mariatta]

Amazing! Thanks @mozillazg ! 🌮

[brettcannon]

@gvanrossum #1 tracks renaming the PEPs. As for cleaning up pep2html, we could either do that or try and build the PEPs using sphinx ( #2 ).

[brettcannon]

And with PEP 9 now converted, this is done! Thanks to everyone who helped make this happen! And now on to #1 😃