Skip to content

gh-144473: Add "steal" term to glossary; clarify "stealing" on error#144502

Open
encukou wants to merge 3 commits intopython:mainfrom
encukou:steal-doc
Open

gh-144473: Add "steal" term to glossary; clarify "stealing" on error#144502
encukou wants to merge 3 commits intopython:mainfrom
encukou:steal-doc

Conversation

@encukou
Copy link
Member

@encukou encukou commented Feb 5, 2026

encukou and others added 3 commits February 5, 2026 14:26
With one exception, all "stealing" functions also steal on error,
but it makes sense to note this in each case.
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
@encukou
Copy link
Member Author

encukou commented Feb 5, 2026

@ZeroIntensity

I'm not a huge fan of putting "steal(s)" in quotations. If the user is confused about the term, then they can just click it to go to the glossary. Otherwise, the user knows the term, so it shouldn't be in scare quotes.

Noted.
Are you aware of the discussion about this in capi-workgroup/problems#11?

@ZeroIntensity
Copy link
Member

I wasn't aware of that discussion. Thanks for the tip.

I'm still not convinced that putting quotation marks around it is the right approach; these are scare quotes, which are used for ideas that are disputed or skeptical, so I think it's a bit of a contradiction to put scare quotes around "steal" when we seem to have coined the term. It makes us seem like we don't trust the term or are taking it from somewhere else, which isn't true, unless I'm missing some history here.

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

Labels

awaiting core review docs Documentation in the Doc dir needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes skip news topic-C-API

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants