prepare-docs-for-afs: Allow reuse

Allow reuse of the roles for other directories than doc/build/html with
making doc_build_dir a variable that can be overwritten. This allows to
use the role also for e.g. deploy-guide that lives under
deploy-guide/source and builds under deploy-guide/build.

Change-Id: I61cd84be201d14d0a1d5daba3a45c8797496bc7f
Needed-By: Ifff767a95e6283c54033bababd3dae84bb19adb6

roles/prepare-docs-for-afs/README.rst

@@ -1 +1,11 @@
-Prepare built openstack docs to be published to the OpenStack AFS cell.
+Prepare built OpenStack docs to be published to the OpenStack AFS cell.
+
+.. zuul:rolevar:: zuul_work_dir
+   :default: {{ zuul.project.src_dir }}
+
+   Directory to build documentation in.
+
+.. zuul:rolevar:: doc_build_dir
+   :default: {{ zuul_work_dir }}/doc/build
+
+   Directory that contains the built documentation.

roles/prepare-docs-for-afs/defaults/main.yaml

@@ -1 +1,2 @@
 zuul_work_dir: "src/{{ zuul.project.canonical_name }}"
+doc_build_dir: "{{ zuul_work_dir }}/doc/build"

roles/prepare-docs-for-afs/tasks/main.yaml

@@ -1,7 +1,3 @@
-- name: Set build dir fact
-  set_fact:
-    doc_build_dir: "{{ zuul_work_dir }}/doc/build"
-
 - name: Write marker text
   copy:
     dest: "{{ doc_build_dir }}/html/.root-marker"