How-to guides: troubleshooting problems
---------------------------------------

In the following guides,
you can learn how to fix common problems using Read the Docs.

⏩️ :doc:`/guides/build-troubleshooting`
    A list of common errors and resolutions encountered in the :doc:`build process </builds>`.

⏩️ :doc:`/guides/build-using-too-many-resources`
    A list of the most common issues that are slowing down builds.
    Even if you are not facing any immediate performance issues,
    it's always good to be familiar with the most common ones.

.. File locations are a bit odd here because of legacy.
.. We will move files to new locations and create redirects in a later refactor

.. toctree::
   :hidden:

   /guides/build-troubleshooting
   /guides/build-using-too-many-resources