Merge pull request #1305 from claw-explorer/docs-fix-broken-links

docs: fix toctree and broken doc reference warnings

Author: niccokunzmann

CHANGES.rst

@@ -51,7 +51,7 @@ Documentation
 - Add Repology badge and distribution installation instructions to install documentation. :issue:`1119`
 - Updated references to :class:`~icalendar.prop.uri.vUri` and :class:`~icalendar.enums.RELTYPE` classes in :file:`attr.py`. :issue:`1158`
 - Convert docstrings in ``attr.py`` and ``cal/calendar.py`` to Google Style format. :issue:`1072`
-- Explained import shortcuts in :doc:`component-api` documentation. :issue:`1161`
+- Explained import shortcuts in :doc:`../explanation/api-design` documentation. :issue:`1161`
 - Added tutorial for creating a calendar with events with attendees. :pr:`1262`
 - Added recognition of NLnet Foundation for its funding and Open Collective for donations to the documentation footer. :issue:`1214`
 - Documented ``vText`` properties according to :rfc:`5545#section-3.3.11`. :issue:`742`

docs/index.rst

@@ -90,6 +90,13 @@ icalendar lets you create, inspect, and modify calendaring information with Pyth
 
     tutorials/index
 
+.. toctree::
+    :caption: Explanation
+    :maxdepth: 2
+    :hidden:
+
+    explanation/index
+
 .. toctree::
     :caption: Reference
     :hidden: