[Meta] Gather support for Framework :: Sphinx :: Domain PyPI classifier

[jdillard]

The list of domains in the docs is somewhat outdated and I think it would be useful if we could take advantage of the PyPI trove classifiers and create a Framework :: Sphinx :: Domain, similar to Framework :: Sphinx :: Extension. But first we need to have the classifier approved and created using these guidelines:

• New Framework classifiers should be created if they are "notable;" and
• They will be of immediate use to existing projects (in other words, no creating classifiers simply in anticipation of future uses)
  We understand that "notability" is subjective and we'd appreciate help judging that.

As to the other guideline ('immediate use to existing projects'), it's been suggested that

• Requestors can demonstrate this by providing links to 10 or more existing PyPI projects that have expressed a desire to use the classifier; or
• Another way to demonstrate this would be to have 10 or more other project maintainers submit comments on the requesting issue about their desire to use the classifier.

If you maintain a Sphinx domain and think a Framework :: Sphinx :: Domain would be useful for helping people find your domain as well as the greater Sphinx ecosystem, please leave a comment expressing interest in using the classifier with a link to the package that you maintain to help with the approval process.

[AA-Turner]

Note: there are ~200 Framework :: Sphinx :: Extension packages listed on PyPI that match the term "domain".

A

[joeced]

I'm interested, I maintain the MATLAB Domain at

https://github.com/sphinx-contrib/matlabdomain

See sphinx-contrib/matlabdomain#210

[markstory]

I can see the additional classifier being helpful to folks looking for domains. 👍. I maintain the php domain

[taminomara]

+1, that'd be useful (author of AntLR4 domain).

[AWhetter]

I can see this being useful. Finding whether a domain exists currently involves using a search engine for something like "graphql sphinx domain" and hoping that brings something up, which might not always be the case for new projects. Alternatively a user could use the unreliable method of searching for packages with a common naming convention like "gqldomain" or "graphqldomain", but there's no guarantee that the naming convention is followed.

So if this classifier existed then I'd make use of it on https://github.com/AWhetter/graphqldomain

[SilverRainZ]

+1 from the any domain.

[Paebbels]

As maintainer of VHDL/VHDLDomain I'm interested.

Framework :: Sphinx :: Extension is nice, but not specific enough.

[danwos]

Also interested in this.
Mostly as a maintainer of Sphinx-Bazel, but also as I'm maintaining an automated list of Sphinx-Extensions, which is based on the Classifiers: https://awesomesphinx.useblocks.com/

[hio]

+1 from erlangdomain.

[cblegare]

+1 from sphinx-compendia which is not a domain per se but still a simple API for creating Sphinx domains and structuring arbitrary collections.

EDIT
+1 from sphinx-terraform and sphinx-gherkin

[jdillard]

That makes 10! I created the request to add the Framework :: Sphinx :: Domain classifier here: pypa/trove-classifiers#163

edit: It got accepted and merged! Now just need to wait for the 2023.11.22 release to get merged.

[jdillard]

The new trove classifiers were merged in pypi/warehouse#15012, and I'm fairly sure that was the last step but not 100% sure since it doesn't show up on PyPi if no packages are using it. Would anyone want to test out making a release with the new Framework :: Sphinx :: Domain to confirm it is live?

[joeced]

Confirmed! I released a new version of the MATLAB Domain and it's now listed when searching for Framework :: Sphinx :: Domain:

https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Domain

[AA-Turner]

Closing as the trove classifier now exists!

A