cleanup docs, make consistent, use furo

More misc cleanup.

Author: woodruffw

README.md

@@ -1,8 +1,7 @@
 # stdlib-list
 
-This package includes lists of all of the standard libraries for Python 2.6,
-2.7, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, and 3.9 along with the code for
-scraping the official Python docs to get said lists.
+This package includes lists of all of the standard libraries for Python 2.6
+through 3.11.
 
 **IMPORTANT**: If you're on Python 3.10 or newer, you **probably don't need this library**.
 See [`sys.stdlib_module_names`](https://docs.python.org/3/library/sys.html#sys.stdlib_module_names)

docs/conf.py

@@ -30,10 +30,9 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.viewcode",
-    "sphinx_rtd_theme",
 ]
 
-html_theme = "sphinx_rtd_theme"
+html_theme = "furo"
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -48,8 +47,8 @@
 master_doc = "index"
 
 # General information about the project.
-project = "Python Standard Library List"
-copyright = "2015, Jack Maney"
+project = "stdlib-list"
+copyright = "2015, stdlib-list authors"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the

docs/index.rst

@@ -1,21 +1,15 @@
-.. Python Standard Library List documentation master file, created by
-   sphinx-quickstart on Tue Mar 10 02:16:08 2015.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
+stdlib-list
+===========
 
-Python Standard Library List
-========================================================
+This package includes lists of all of the standard libraries for Python 2.6
+through 3.11.
 
-This package includes lists of all of the standard libraries for Python 2.6, 2.7, 3.2, 3.3, and 3.4, along with the code for scraping the official Python docs to get said lists.
+.. note::
 
-Listing the modules in the standard library? Wait, why on Earth would you care about that?!
-===========================================================================================
-
-Because knowing whether or not a module is part of the standard library will come in handy in `a project of mine <https://github.com/jackmaney/pypt>`_. `And I'm not the only one <http://stackoverflow.com/questions/6463918/how-can-i-get-a-list-of-all-the-python-standard-library-modules>`_ who would find this useful. Or, the TL;DR answer is that it's handy in situations when you're analyzing Python code and would like to find module dependencies.
-
-After googling for a way to generate a list of Python standard libraries (and looking through the answers to the previously-linked Stack Overflow question), I decided that I didn't like the existing solutions. So, I started by writing a scraper for the TOC of the Python Module Index for each of the versions of Python above.
-
-However, web scraping can be a fragile affair. Thanks to `a suggestion <https://github.com/jackmaney/python-stdlib-list/issues/1#issuecomment-86517208>`_ by `@ncoghlan <https://github.com/ncoghlan>`_, and some further help from `@birkenfeld <https://github.com/birkenfeld>`_ and `@epc <https://github.com/epc>`_, the population of the lists is now done by grabbing and parsing the Sphinx object inventory for the official Python docs of each relevant version.
+   If you're on Python 3.10 or newer, you **probably don't need this library**.
+   See `sys.stdlib_module_names <https://docs.python.org/3/library/sys.html#sys.stdlib_module_names>`_
+   and `sys.builtin_module_names <https://docs.python.org/3/library/sys.html#sys.builtin_module_names>`_
+   for similar functionality.
 
 Contents
 ========

pyproject.toml

@@ -30,7 +30,7 @@ Source = "https://github.com/pypi/stdlib-list"
 [project.optional-dependencies]
 test = ["pytest", "pytest-cov", "coverage[toml]"]
 lint = ["black", "mypy", "ruff"]
-doc = ["sphinx", "sphinx_rtd_theme"]
+doc = ["sphinx", "furo"]
 dev = ["build", "stdlib-list[test,lint,doc]"]
 # CI only: used for list generation for Python versions < 3.10.
 support = ["sphobjinv"]