Skip to content

Conversation

sirosen
Copy link
Contributor

@sirosen sirosen commented Sep 27, 2025

Outside of titles and other contexts, convert this term to lowercase.
This usage better matches other terms defined in the packaging specifications, such as "script metadata" and "dependency specifiers".

For reference, this change was inspired by:
#1847 (comment)


I like having some kind of styling which indicates a term.
However, I would like to keep docs consistent. If there's some reasonable choice of styling (e.g., boldface) which can indicate a specialized term, I would be happy to work on applying it consistently across the site.


📚 Documentation preview 📚: https://python-packaging-user-guide--1918.org.readthedocs.build/en/1918/

Outside of titles and other contexts, convert this term to lowercase.
This usage better matches other terms defined in the packaging
specifications, such as "script metadata" and "dependency specifiers".

For reference, this change was inspired by:
pypa#1847 (comment)
@webknjaz
Copy link
Member

:term:`dependency groups`

on first use in a document, followed by italics in the following uses?

I recently discovered that CPython has a great style guide: https://devguide.python.org/documentation/style-guide/#links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants