diff --git a/packaging.html b/packaging.html index 7aa7206..07c382f 100644 --- a/packaging.html +++ b/packaging.html @@ -182,38 +182,27 @@ chardet/
The Python Package Index (“PyPI”) contains thousands of Python libraries. Proper classification metadata will allow people to find yours more easily. -
The PyPI classification system is based on SourceForce’s software map. Classifiers are strings, but they are not freeform. - -
The classifiers parameter to the Distutils setup() function is a list of strings. These strings are not freeform. All of your classifier strings should come from this master list on PyPI.
-☞All of your classifiers should come from this master list on PyPI. +
☞The Python Package Index lets you browse packages by classifier. You can even select multiple classifiers to narrow your search. Classifiers are not invisible metadata that you can just ignore!
You should always include at least these four classifiers:
"Programming Language :: Python" and "Programming Language :: Python :: 3". If you do not include these, your package will not show up in this list of Python 3-compatible libraries, which linked from the sidebar of every single page of pypi.python.org.
-"License :: whatever". This is the absolute first thing I look for when I’m evaluating third-party libraries. Don’t make me hunt for this vital information. Don’t include more than one license classifier unless your software is explicitly available under multiple licenses (and don’t release software under multiple licenses unless you’re forced to do so).
-"Operating System :: whatever". If your software only runs on Windows (or Mac OS X, or Linux), I want to know sooner rather than later. If your software works anywhere without any platform-specific code, use the classifier "Operating System :: OS Independent". Multiple classifiers are allowed.
+"Programming Language :: Python" and "Programming Language :: Python :: 3". If you do not include these, your package will not show up in this list of Python 3-compatible libraries, which linked from the sidebar of every single page of pypi.python.org.
+"Operating System :: OS Independent". Multiple Operating System classifiers are only necessary if your software requires specific support for each platform. (This is not common.)
I strongly recommend that you also include the following classifications:
"Development Status :: whatever". Pick one. Be honest.
-"Intended Audience :: whatever". Pick one. The most common choices are Developers, End Users/Desktop, Science/Research, and System Administrators.
-"Topic :: whatever". There are a large number of topics available. Choose all that apply.
+Developers, End Users/Desktop, Science/Research, and System Administrators. Pick one.
+