make html failure

[faridcher]

Problem

(venv) /media/d/db/postgresql/pgrouting/workshop/docs $ make html                                                                           [3/8275]
sphinx-build -b html -d _build/doctrees   source _build/html                                                                                      
Running Sphinx v7.2.6                                                                                                                             
                                                                                                                                                  
Configuration error:
config directory doesn't contain a conf.py file (/media/d/db/postgresql/pgrouting/workshop/docs/source)
make: *** [Makefile:46: html] Error 2

THen I edit docs/Makefile and set SPHINXOPTS = -c ./
I get:

(venv) /media/d/db/postgresql/pgrouting/workshop/docs $ make html
sphinx-build -b html -d _build/doctrees  -c ./ source _build/html
Running Sphinx v7.2.6
WARNING: html_static_path entry '@PGR_WORKSHOP_SOURCE_DIR@/docs/_static' does not exist
WARNING: logo file '@PGR_WORKSHOP_SOURCE_DIR@/docs/_static/images/pgrouting.png' does not exist
WARNING: favicon file '@PGR_WORKSHOP_SOURCE_DIR@/docs/_static/images/favicon.ico' does not exist
building [mo]: targets for 0 po files that are out of date
writing output... 
building [html]: targets for 0 source files that are out of date
updating environment: [new config] 0 added, 0 changed, 0 removed
reading sources... 

Sphinx error:
root file /media/d/db/postgresql/pgrouting/workshop/docs/source/index.rst not found
make: *** [Makefile:46: html] Error 2

Expectation
build the workshop html files

Platform/versions

SELECT version();
                                                 version                                                  
----------------------------------------------------------------------------------------------------------
 PostgreSQL 15.4 (Debian 15.4-1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 13.2.0-1) 13.2.0, 64-bit

[cvvergara]

Simplest way to create the workshop

dropdb city_routing
mkdir build
cd build 
cmake  ..
make html
cd ..

[faridcher]

so the Readme.md needs to be updated. thanks