📝 docs: add upstream links and logo

Link pyenv, mise, asdf, uv, and filelock to their upstream docs.
Add SVG logo to the sidebar via furo theme options.

Author: gaborbernat

docs/_static/logo.svg

@@ -37,3 +37,8 @@
 html_last_updated_fmt = datetime.now(tz=timezone.utc).isoformat()
 pygments_dark_style = "monokai"
 html_show_sourcelink = False
+html_static_path = ["_static"]
+html_theme_options = {
+    "light_logo": "logo.svg",
+    "dark_logo": "logo.svg",
+}

docs/conf.py

@@ -59,14 +59,16 @@ py-discovery detects this and resolves it to the real binary.
         style Use fill:#4a9f4a,stroke:#2a6f2a,color:#fff
         style Skip fill:#d94a4a,stroke:#8f2a2a,color:#fff
 
-For mise and asdf, the ``MISE_DATA_DIR`` and ``ASDF_DATA_DIR`` directories are searched. The shim directory is
-identified via the ``PYENV_ROOT``, ``MISE_DATA_DIR``, or ``ASDF_DATA_DIR`` environment variables.
+For `mise <https://mise.jdx.dev/>`_ and `asdf <https://asdf-vm.com/>`_, the ``MISE_DATA_DIR`` and ``ASDF_DATA_DIR``
+directories are searched. The shim directory is identified via the ``PYENV_ROOT``, ``MISE_DATA_DIR``, or
+``ASDF_DATA_DIR`` environment variables.
 
 Cache design
 ------------
 
 The :class:`~py_discovery.DiskCache` stores interpreter metadata as JSON files under
-``<root>/py_info/4/<sha256>.json``, where the hash is derived from the interpreter path. File locking via ``filelock``
+``<root>/py_info/4/<sha256>.json``, where the hash is derived from the interpreter path. File locking via
+`filelock <https://py-filelock.readthedocs.io/>`_
 ensures safe concurrent access.
 
 .. mermaid::
@@ -86,7 +88,7 @@ ensures safe concurrent access.
 The cache layer uses a :class:`typing.Protocol` (:class:`~py_discovery.PyInfoCache`), so any object with the right
 method signatures works as a cache backend -- no inheritance required. Two built-in implementations are provided:
 
-- :class:`~py_discovery.DiskCache` -- persistent JSON + filelock storage.
+- :class:`~py_discovery.DiskCache` -- persistent JSON + `filelock <https://py-filelock.readthedocs.io/>`_ storage.
 - ``cache=None`` -- disables caching, useful for one-shot scripts or testing.
 
 Spec format

docs/explanation.rst

@@ -56,7 +56,7 @@ Implement the :class:`~py_discovery.PyInfoCache` protocol to provide your own st
        def py_info_clear(self) -> None: ...
 
 The built-in :class:`~py_discovery.DiskCache` stores JSON files under ``<root>/py_info/4/<sha256>.json`` with
-``filelock``-based locking. Pass ``cache=None`` to disable caching entirely.
+`filelock <https://py-filelock.readthedocs.io/>`_-based locking. Pass ``cache=None`` to disable caching entirely.
 
 Using ``get_interpreter`` directly
 -----------------------------------

docs/how-to/standalone-usage.rst

@@ -2,8 +2,9 @@ py-discovery
 ============
 
 A Python interpreter discovery library. ``py-discovery`` finds Python interpreters on your system by searching PATH,
-version managers (pyenv, mise, asdf), the Windows registry (:pep:`514`), and uv-managed installations. Results are cached
-to disk for fast repeated lookups.
+version managers (`pyenv <https://github.com/pyenv/pyenv>`_, `mise <https://mise.jdx.dev/>`_,
+`asdf <https://asdf-vm.com/>`_), the Windows registry (:pep:`514`), and `uv <https://docs.astral.sh/uv/>`_-managed
+installations. Results are cached to disk for fast repeated lookups.
 
 .. toctree::
    :caption: Tutorials