Skip to content

Replace :platform: with .. availability:: in socket.ioctl doc. - #127122

Merged
encukou merged 1 commit into
python:mainfrom
junkmd:socket_ioctl_availability
Nov 25, 2024
Merged

Replace :platform: with .. availability:: in socket.ioctl doc.#127122
encukou merged 1 commit into
python:mainfrom
junkmd:socket_ioctl_availability

Conversation

@junkmd

@junkmdjunkmd commented Nov 21, 2024

Copy link
Copy Markdown
Contributor

When documenting the platforms on which an API is available, it was clarified in the discussion on gh-126686 that ".. availability:: is generally the correct one to use" rather than :platform:.

I was a bit confused after seeing both being used in the socket documentation, and I’d like to ensure that similar confusion doesn’t arise in the future.


📚 Documentation preview 📚: https://cpython-previews--127122.org.readthedocs.build/

@bedevere-appbedevere-appBot added docs Documentation in the Doc dir skip news awaiting review labels Nov 21, 2024
@junkmd
junkmdforce-pushed the socket_ioctl_availability branch from 4414b08 to 0c7def9CompareNovember 22, 2024 23:39
@encukou
encukou merged commit f4f075b into python:mainNov 25, 2024
@junkmd
junkmd deleted the socket_ioctl_availability branch November 25, 2024 13:04
ebonnal pushed a commit to ebonnal/cpython that referenced this pull request Jan 12, 2025
…ythonGH-127122)
In `socket.ioctl`, `:platform:` -> `.. availability::`
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docsDocumentation in the Doc dirskip issueskip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants

@junkmd@encukou