From 781604b368d6c15f1a054855262c07127731012d Mon Sep 17 00:00:00 2001
From: RhodeCode Admin <admin@rhodecode.com>
Date: Thu, 3 Jul 2025 21:23:33 +0200
Subject: [PATCH] docs: fix howto

---
 docs/.howto | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/.howto b/docs/.howto
index 4f74b8c7..7868453a 100644
--- a/docs/.howto
+++ b/docs/.howto
@@ -1,6 +1,10 @@
-## BUILD
-# cd docs
-# docker build --tag sphinx-doc-build-rc .
+## BUILD Image for building docs and push to rhodecode registry
+
+cd docs
+docker buildx build --platform linux/amd64 --tag rhodecode/sphinx-doc-build .
 
 # Build Docs
-# cd .. && docker run --rm -v $(pwd):/project --workdir=/project/docs sphinx-doc-build-rc make clean html
+# run from the project root dir; not docs dir
+
+docker run --rm -v $PWD:/project --workdir=/project/docs rhodecode/sphinx-doc-build make clean html SPHINXOPTS="-W"
+