Skip to content

Add FAQ entry about requesting new Trove classifiers #3410

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

Merged
merged 7 commits into from
Mar 31, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .github/ISSUE_TEMPLATE/new-trove-classifier.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
Request to add a new Trove classifier.

## The name of the classifier you would like to add
<!-- Classifier name -->

## Why do you want to add this classifier?
<!--
Please include a brief explanation to justify your request.
Why do the current classifiers not meet your need?
How many projects do you expect to use this new classifier?
-->
8 changes: 8 additions & 0 deletions warehouse/templates/pages/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@
{% macro file_name_reuse() %}Why am I getting a "Filename or contents already exists" or "Filename has been previously used" errors?{% endmacro %}
{% macro project_name() %}Why isn't my desired project name available?{% endmacro %}
{% macro project_name_claim() %}How do I claim an abandoned or previously registered project name?{% endmacro %}
{% macro new_classifier() %}How do I request a new Trove classifier?{% endmacro %}
{% macro feedback() %}Where can I report a bug or provide feedback?{% endmacro %}
{% macro maintainers() %}Who maintains PyPI?{% endmacro %}
{% macro sponsors() %}What powers PyPI?{% endmacro %}
Expand Down Expand Up @@ -83,6 +84,7 @@ <h2><a href="#problems">Problems</a></h2>
<li><a href="#file-size-limit">{{ file_size_limit() }}</a></li>
<li><a href="#admin-intervention">{{ admin_intervention() }}</a></li>
<li><a href="#file-name-reuse">{{ file_name_reuse() }}</a></li>
<li><a href="#new-classifier">{{ new_classifier() }}</a></li>
<li><a href="#feedback">{{ feedback() }}</a></li>
</ul>
</section>
Expand Down Expand Up @@ -252,6 +254,12 @@ <h3 id="file-name-reuse">{{ file_name_reuse() }}</h3>
To avoid this situation, <a href="https://packaging.python.org/guides/using-testpypi/">use Test PyPI to perform and check your upload first</a>, before uploading to <a href="https://pypi.org">pypi.org</a>.
</p>

<h3 id="new-classifier">{{ new_classifier() }}</h3>
<p>
If you would like to request a new Trove classifier please file a bug on our <a href="https://github.com/pypa/warehouse/issues/new?template=new-trove-classifier.md" target="_blank" rel="noopener">issue tracker</a>. Please include the name of the requested classifier and a brief justification of why it is important.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like this wording -- thanks.

</p>
{{ code_of_conduct() }}

<h3 id="feedback">{{ feedback() }}</h3>
<p>
We welcome <em>constructive</em> feedback and bug reports via our <a href="https://github.com/pypa/warehouse/issues" target="_blank" rel="noopener">issue tracker</a>. Before writing a new issue, please first check that a similar issue does not already exist.
Expand Down