docs(sphinx): update docs for better readability, added description sections, feature list

Author: shakefu

docs/index.rst

@@ -1,15 +1,24 @@
-Pytool |version|
-================
-
-Pytool is available on PyPI: `<http://pypi.python.org/pypi/pytool/>`_
-
-Pytool is compatible with Python 2 (tested against 2.7) or Python 3.3 and
-higher. *Compatibility added August 4, 2015.*
-
-Pytool's source is hosted on Github: `<http://github.com/shakefu/pytool>`_
-
-Any comments, issues or requests should be submitted via Github:
-`<https://github.com/shakefu/pytool/issues>`_
+Pytool - Helpers for Python
+===========================
+
+Pytool is a Python helper package that contains a lot of helpful little methods
+and functions to make your life a little easier and your day a little better.
+Enjoy! These include:
+
+* Command helpers for easily making CLI tools based on :mod:`argparse`
+* Language helpers which implement common Python language constructs like
+  singletons, namespace objects, class properties, and proxy objects
+* Time helpers for easily working with UTC, relative times, and converting
+  between formats
+* Text helpers to respect console width when wrapping and printing
+* JSON helpers for easily parsing and serializing JSON with customization
+* ... and more!
+
+Pytool is compatible with Python 3.10 and higher.  Older versions of Python are
+no longer supported going forward. If you need support for earlier Python
+versions, please check the `releases
+<https://github.com/shakefu/pytool/releases>`_ for older versions of Pytool.
+*Compatibility updated June 9, 2025.*
 
 Contributors
 ------------
@@ -18,19 +27,50 @@ Contributors
 * `dshen109 <https://github.com/dshen109>`_
 * `abendig <https://github.com/abendig>`_
 
+----
+
+Contents
+--------
+
+.. contents::
+   :local:
 
 .. toctree::
-   :maxdepth: 5
-   :titlesonly:
+   :maxdepth: 3
 
    pytool
 
-
 .. toctree::
    :hidden:
 
    changes
 
+Installation
+^^^^^^^^^^^^
+
+Pytool is available on PyPI: `<http://pypi.python.org/pypi/pytool/>`_.
+
+.. code-block:: bash
+
+   pip install pytool
+
+Contributing
+^^^^^^^^^^^^
+
+Pytool is open source and available on Github:
+`<http://github.com/shakefu/pytool>`_.
+
+Any comments, issues or requests should be submitted via Github:
+`<https://github.com/shakefu/pytool/issues>`_.
+
+License
+^^^^^^^
+
+Pytool is licensed under the MIT License. See the `LICENSE
+<https://github.com/shakefu/pytool/blob/main/LICENSE.md>`_ file for details.
+
+Changelog
+^^^^^^^^^
 
 See the :doc:`changes` for a list of changes.