X Tutup
The Wayback Machine - https://web.archive.org/web/20260311215747/https://github.com/python/cpython/pull/30418
Skip to content

Align .suffixes example with .suffix example in pathlib doc#30418

Closed
hoffmann wants to merge 1 commit intopython:3.10from
hoffmann:patch-1
Closed

Align .suffixes example with .suffix example in pathlib doc#30418
hoffmann wants to merge 1 commit intopython:3.10from
hoffmann:patch-1

Conversation

@hoffmann
Copy link

@hoffmann hoffmann commented Jan 5, 2022

No description provided.

@the-knights-who-say-ni
Copy link

Hello, and thanks for your contribution!

I'm a bot set up to make sure that the project can legally accept this contribution by verifying everyone involved has signed the PSF contributor agreement (CLA).

Recognized GitHub username

We couldn't find a bugs.python.org (b.p.o) account corresponding to the following GitHub usernames:

@hoffmann

This might be simply due to a missing "GitHub Name" entry in one's b.p.o account settings. This is necessary for legal reasons before we can look at this contribution. Please follow the steps outlined in the CPython devguide to rectify this issue.

You can check yourself to see if the CLA has been received.

Thanks again for the contribution, we look forward to reviewing it!

@merwok
Copy link
Member

merwok commented Jan 5, 2022

Can you say more? I don’t understand the change being proposed.

@taleinat
Copy link
Contributor

taleinat commented Jan 8, 2022

Can you say more? I don’t understand the change being proposed.

"Align" seems to mean making this consistent with the examples for .suffix just above.

This does seems like an improvement to me, because:

  • ".tar.gar" is unusual and a bit confusing.
  • Having an example with a single extension (the most common case) seems useful.
  • It parallels the examples for the similar .suffix, and so clearly highlights the differences.

@taleinat
Copy link
Contributor

taleinat commented Jan 8, 2022

(Oops! I changed the base branch from 3.10 to main, and this requested a review from about half of the maintainers... sorry for the noise!)

@taleinat
Copy link
Contributor

taleinat commented Jan 8, 2022

@hoffmann, I'm inclined to merge this PR, and for such a minor docs change we can forgo signing the CLA.

However, before we can merge this, we'll need to rebase this against the main branch, and then change the PR to be against the main branch, rather than 3.10. Could you please do so?

@terryjreedy terryjreedy changed the title Align suffixes example Align .suffixes example with .suffix example Jan 8, 2022
@terryjreedy
Copy link
Member

The title puzzled me also until I read Tal's explanation; I changed it accordingly. I agree that this is an improvement, though trivial enough to forego CLA for this PR. It might be easier to close this and start over with a checkout branched from 'main'.

@peter: 'main' is our development branch and we nearly always patch it first and backport if appropriate.

@merwok merwok changed the title Align .suffixes example with .suffix example Align .suffixes example with .suffix example in pathlib doc Jan 8, 2022
@brettcannon
Copy link
Member

Ignoring the CLA issue, is there a reason this is targeting Python 3.10 and not main?

@terryjreedy
Copy link
Member

Targeting 3.10 is an error, which I why I suggested closing and starting over (versus trying to fix by rebasing), as retargeting this one failed.

@github-actions
Copy link

This PR is stale because it has been open for 30 days with no activity.

@github-actions github-actions bot added the stale Stale PR or inactive for long period of time. label Feb 12, 2022
@brettcannon
Copy link
Member

I am closing this as the CLA is still not signed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir skip issue skip news stale Stale PR or inactive for long period of time.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants

X Tutup