From 504ddf08f4105f29a4a6edd019dc2d59f9955e12 Mon Sep 17 00:00:00 2001
From: Andre Sailer <andre.philippe.sailer@cern.ch>
Date: Thu, 20 Feb 2025 14:58:27 +0100
Subject: [PATCH] sweep: #8053 fix doc readme

---
 docs/README | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/README b/docs/README
index 82d26615fc8..57547330219 100644
--- a/docs/README
+++ b/docs/README
@@ -3,10 +3,19 @@ How to build DIRAC documentation
 
 1. Create DIRAC client environment by an appropriate
    source bashrc
+   or
+   source diracos/diracosrc
+
+   Appropriate means according to the version of DIRAC you want to build the documentation for. See also the [developer
+   instructions](https://dirac.readthedocs.io/en/latest/DeveloperGuide/DevelopmentEnvironment/DeveloperInstallation/editingCode.html#installing-the-local-version)
+
+
+1.1 Depending on how you installed DIRAC you might need to install
+   pip install sphinx_rtd_theme sphinx_design
 
 2. Go to the Documentation directory of the DIRAC source code repository
    cd DIRAC/docs/
-   export PYTHONPATH=$PWD/diracdoctools:$PYTHONPATH
+   export PYTHONPATH=$PWD:$PYTHONPATH
 
 3. Run the documentation building script
 
@@ -14,6 +23,8 @@ How to build DIRAC documentation
 
       make htmlall
 
+   Note: You must avoid having the string "test" in your folder structure or no code documentation will be created.
+
 3.1 to run incremental builds after rst files have changed, only run
 
    make html