From a8f3639ad36a5d58e43c015d983b46f578da877a Mon Sep 17 00:00:00 2001
From: Petr Viktorin <encukou@gmail.com>
Date: Aug 11 2018 08:10:21 +0000
Subject: Document how to build previews


---

diff --git a/modules/ROOT/pages/pr.adoc b/modules/ROOT/pages/pr.adoc
index 474ad66..d25dcd0 100644
--- a/modules/ROOT/pages/pr.adoc
+++ b/modules/ROOT/pages/pr.adoc
@@ -74,7 +74,26 @@ $ git add en-US/pr.adoc
 $ git commit -m 'begin describing pull request workflow'
 ....
 
-. #FIXME# - how to build previews
+. Preview the result.
+The first time you do this, you will need to install Docker and start it.
+On Fedora, use these commands:
++
+....
+$ sudo dnf install docker
+$ sudo systemctl start docker
+....
++
+With Docker started, use scripts included in the repository to build
+and view documentation.
+These scripts might ask for a root password.
++
+....
+$ ./build.sh && ./preview.sh
+....
++
+While `preview.sh` is running, the resulting documentation will be available at
+link:http://localhost:8080[http://localhost:8080].
+Visit the address in your browser and check your work.
 
 . Push your changes to Pagure.
 +