How-to guides: project setup and configuration
==============================================

The following how-to guides help you solve common tasks and challenges in the setup and configuration stages.

⏩️ :doc:`Connecting your Read the Docs account to your Git provider </guides/connecting-git-account>`
    Steps to connect an account on |git_providers_or| with your Read the Docs account.

⏩️ :doc:`Connecting your Git repository automatically </connected-accounts>`
    Once your account is connected to your Git provider,
    adding and configuring a Git repository **automatically** is possible for |git_providers_and|.

⏩️ :doc:`Connecting your Git repository manually </guides/git-integrations>`
    If you are connecting a Git repository from another provider (for instance Gitea or Codeberg),
    this guide tells you how to add and configure the Webhook **manually**.

⏩️ :doc:`Managing custom domains </guides/custom-domains>`
    Hosting your documentation using your own domain name, such as ``docs.example.com``.

⏩️ :doc:`Using custom URL redirects in documentation projects </guides/redirects>`
    Configuring your Read the Docs project for redirecting visitors from one location to another.

⏩️ :doc:`Managing subprojects </guides/subprojects>`
    Need several projects under the same umbrella?
    Start using subprojects, which is a way to host multiple projects under a "main project".

⏩️ :doc:`Hiding a version </guides/hiding-a-version>`
    Is your version (flyout) menu overwhelmed and hard to navigate?
    Here's how to make it shorter.

.. seealso::

   :doc:`/tutorial/index`
      All you need to know to get started.


.. toctree::
   :maxdepth: 1
   :hidden:

   Connecting your Read the Docs account to your Git provider </guides/connecting-git-account>
   Connecting your Git repository automatically </connected-accounts>
   Connecting your Git repository manually </guides/git-integrations>
   Managing custom domains </guides/custom-domains>
   Managing subprojects </guides/subprojects>
   Hiding a version </guides/hiding-a-version>
   Using custom URL redirects in documentation projects </guides/redirects>