From 10a823bb2ce44798fbeed9d61317f5c656a2be43 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Mon, 28 Aug 2023 13:08:03 +0200
Subject: [PATCH] Docs: update `conda` config key to mention
 `build.tools.python`

Make it clear that when using `conda` it's required to use `build.tools.python`
with Conda or Mamba.

Related https://github.com/readthedocs/readthedocs.org/issues/8595#issuecomment-1693166393
---
 docs/user/config-file/v2.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/user/config-file/v2.rst b/docs/user/config-file/v2.rst
index 8984b6ebfe8..62a09815ac6 100644
--- a/docs/user/config-file/v2.rst
+++ b/docs/user/config-file/v2.rst
@@ -236,6 +236,11 @@ Configuration for Conda support.
 
    version: 2
 
+   build:
+     os: "ubuntu-22.04"
+     tools:
+       python: "mambaforge-22.9"
+
    conda:
      environment: environment.yml
 
@@ -247,6 +252,10 @@ The path to the Conda `environment file <https://conda.io/projects/conda/en/late
 :Type: ``path``
 :Required: ``false``
 
+.. note::
+
+   When using Conda, it's required to specify ``build.tools.python`` to tell Read the Docs to use whether Conda or Mamba to create the environment.
+
 build
 ~~~~~