respond to review by @drammock

Author: gabalafou

src/pydata_sphinx_theme/__init__.py

@@ -44,6 +44,8 @@ def update_config(app):
         raise ExtensionError(
             "`icon_links` must be a list of dictionaries, you provided "
             f"type {type(theme_options.get('icon_links'))}."
+            "If you wish to disable this feature, either do not provide "
+            "a value (leave undefined), or set to an empty list."
         )
 
     # Set the anchor link default to be # if the user hasn't provided their own

src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf

@@ -37,6 +37,7 @@ logo_link =
 surface_warnings = True
 back_to_top_button = True
 search_as_you_type = False
+shorten_urls = True
 
 # Template placement in theme layouts
 navbar_start = navbar-logo