instruction to run the doc worker

1 files changed, 29 insertions, 2 deletions

diff --git a/doc/onboarding.texi b/doc/onboarding.texi
index 2fe9c6d..39fe304 100644
--- a/doc/onboarding.texi
+++ b/doc/onboarding.texi
@@ -87,8 +87,35 @@ There is also a "restart" script, runnable as follows:
 $ ~/buildbot/restart.sh
 @end example
 
-@subsubsection Selenium worker
+@subsection Documentation worker
+
+This worker is responsible for building all the documentation on
+@code{https://docs.taler.net}.  It is run by the user @code{docbuilder},
+whose home directory must have all the repositories with documentation
+to be built.  Namely,
+
+@itemize
+@item @emph{exchange}
+@item @emph{merchant}
+@item @emph{merchant-frontend-examples}
+@item @emph{deployment} - because of "onboarding" documentation
+@item @emph{api}
+@end itemize
+
+It can be start with the following command:
+
+@example
+$ source ~/buildbot/venv/activate
+$ buildbot-worker start ~/buildbot/worker
+
+# stop it with:
+$ buildbor-worker stop ~/buildbot/worker
 
+# deactivate the virtual env with:
+$ deactivate
+@end example
+
+@subsubsection Selenium worker
 This worker is responsible for running the Selenium wallet test:
 an automatic clicker that performs the cycle withdraw-and-spend.
 
@@ -104,7 +131,7 @@ $ buildbot-worker start ~/buildbot/selenium_worker/
 # stop it with:
 $ buildbot-worker stop ~/buildbot/selenium_worker/
 
-# deactivate the virtual env with
+# deactivate the virtual env with:
 $ deactivate
 @end example