Skip to content

Convert text-based PEPs to reST #4

Closed

Description

@brettcannon

Not really important, but it does unify things.

Activity

  1. Carreau commented on Jun 21, 2016

    @Carreau
    Contributor

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

  2. Rosuav commented on Jun 21, 2016

    @Rosuav
    Contributor

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

  3. Carreau commented on Jun 21, 2016

    @Carreau
    Contributor

    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.

  4. brettcannon commented on Jun 22, 2016

    @brettcannon
    MemberAuthor

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

  5. brettcannon commented on Dec 4, 2016

    @brettcannon
    MemberAuthor

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

  6. Mariatta commented on Dec 4, 2016

    @Mariatta
    Member

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

  7. gvanrossum commented on Dec 4, 2016

    @gvanrossum
    Member
  8. brettcannon commented on Dec 5, 2016

    @brettcannon
    MemberAuthor

    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. 😄

  9. Carreau commented on Dec 25, 2016

    @Carreau
    Contributor

    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.

  10. added a commit that references this issue on Jan 7, 2017
  11. added a commit that references this issue on Jan 7, 2017
  12. brettcannon commented on Jun 2, 2017

    @brettcannon
    MemberAuthor

    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).

  13. brettcannon commented on Aug 16, 2017

    @brettcannon
    MemberAuthor

    Latest list of PEPs (although there are some open PRs for some of these):

    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-0227.txt
    pep-0230.txt
    pep-0231.txt
    pep-0245.txt
    pep-0246.txt
    pep-0252.txt
    pep-0253.txt
    pep-0262.txt
    pep-0275.txt
    pep-0276.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-0354.txt
    pep-0371.txt
    pep-0397.txt
    pep-0452.txt
    pep-3101.txt
    pep-3143.txt
    pep-3148.txt

  14. mozillazg commented on Oct 24, 2017

    @mozillazg
    Contributor

    All done! 🎇🎉

    $ grep -i -L "^Content-Type: \+text/x-rst" *.txt
    pep-0009.txt
    
  15. gvanrossum commented on Oct 24, 2017

    @gvanrossum
    Member

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

  16. Mariatta commented on Oct 24, 2017

    @Mariatta
    Member

    Amazing! Thanks @mozillazg ! 🌮

  17. brettcannon commented on Oct 25, 2017

    @brettcannon
    MemberAuthor

    @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 ).

  18. added a commit that references this issue on Oct 25, 2017
    e808935
  19. added a commit that references this issue on Oct 25, 2017
    7bd9f7c
  20. brettcannon commented on Oct 25, 2017

    @brettcannon
    MemberAuthor

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

  21. added a commit that references this issue on Sep 11, 2019
  22. added a commit that references this issue on Oct 10, 2019
  23. added a commit that references this issue on Sep 23, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions