diff --git a/Procfile b/Procfile index 45a1e8fe..f9da41e5 100644 --- a/Procfile +++ b/Procfile @@ -3,3 +3,4 @@ hydra-queue-runner: ./foreman/start-queue-runner.sh hydra-evaluator: ./foreman/start-evaluator.sh hydra-notify: ./foreman/start-notify.sh postgres: ./foreman/start-postgres.sh +manual: ./foreman/start-manual.sh diff --git a/doc/manual/src/hacking.md b/doc/manual/src/hacking.md index dabc7169..c22b7530 100644 --- a/doc/manual/src/hacking.md +++ b/doc/manual/src/hacking.md @@ -44,6 +44,12 @@ if run with high parallelism [due to an issue in `Test::PostgreSQL`](https://github.com/TJC/Test-postgresql/issues/40) causing database ports to collide. +## Working on the Manual + +By default, `foreman start` runs mdbook in "watch" mode. mdbook listens +at [http://localhost:63332/](http://localhost:63332/) by default, and +will reload the page every time you save. + ## Building To build Hydra and its dependencies: diff --git a/foreman/start-manual.sh b/foreman/start-manual.sh new file mode 100755 index 00000000..5ad78265 --- /dev/null +++ b/foreman/start-manual.sh @@ -0,0 +1,6 @@ +#!/bin/sh + +mdbook serve \ + --port 63332 \ + --dest-dir $(pwd)/.hydra-data/manual \ + $(pwd)/doc/manual/