Skip to content

Clarify "classifiers"/"filters" wording #3452

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
brainwane opened this issue Mar 28, 2018 · 5 comments
Closed

Clarify "classifiers"/"filters" wording #3452

brainwane opened this issue Mar 28, 2018 · 5 comments
Labels
documentation to user test Issues that should be investigated further via user testing usability UX/UI design, user experience, user interface

Comments

@brainwane
Copy link
Contributor

Per conversation on python-list (1, 2), the "Filter projects" section on the left-hand side of the page is not clearly related to the "list of classifiers", and

"Classifiers" is what the relevant package metadata is called, but it's not exactly what the average user would refer to that data as.

What can we do to both serve people who don't know what classifiers are and people who know that term and are specifically thinking in terms of classifiers?

@brainwane brainwane added UX/UI design, user experience, user interface usability bug 🐛 needs UX/UI review needs discussion a product management/policy issue maintainers and users should discuss labels Mar 28, 2018
@brainwane
Copy link
Contributor Author

#3410 adds an FAQ entry about adding a new classifier. As we get more consistent about talking about filters and classifiers, I'd like us to update this wording or add another FAQ to clarify where the "Trove"/"classifier" wording and master list originated.

@drunkwcodes
Copy link

drunkwcodes commented Mar 29, 2018

Maybe introducing https://github.com/nepsilon/search-query-parser and letting users to type search queries like "Framework:Django" in the search bar will help.

Because we are familiar with Google search and Github search.

@nlhkabu
Copy link
Contributor

nlhkabu commented Mar 29, 2018

We could do something like this:

Filter by classifier ℹ️

Hovering your mouse over the icon could then launch a tooltip that describes what a classifier is.
@brainwane could you provide some appropriate text for this?

@nlhkabu nlhkabu added to user test Issues that should be investigated further via user testing and removed needs UX/UI review needs discussion a product management/policy issue maintainers and users should discuss bug 🐛 labels Mar 29, 2018
@brainwane
Copy link
Contributor Author

Gregory Ewing brought up "Categories" which seems, to me, a very sensible name for what we're talking about.

Here's text for the tooltip:

Each project's maintainers give PyPI a list of "trove classifiers" to use to categorize each release, describing who it's for, what systems it can run on, and how mature it is.

@brainwane
Copy link
Contributor Author

brainwane commented Mar 29, 2018

(Background, in case anyone wants to add an FAQ item: the original list of trove classifiers was drawn from Freshmeat and SourceForge lists. The relevant standard is the Core Metadata Specification and the best documentation to point new maintainers to is this part of PyPUG.)

@drunkwcodes that's an interesting idea! I'm going to mention that in #727. Thanks for bringing it up.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation to user test Issues that should be investigated further via user testing usability UX/UI design, user experience, user interface
Projects
None yet
Development

No branches or pull requests

3 participants