diff --git a/README.adoc b/README.adoc index c19e8c8e..24689af0 100644 --- a/README.adoc +++ b/README.adoc @@ -73,8 +73,17 @@ We intend to maintain a linear history on the GitHub `main` branch. [[building]] == Building The Specifications and Reference Pages -If you have installed all <>, you -should be able to build both HTML and PDF outputs for all specifications by: +After cloning the repository you should install all of the <>. +The recommended way to do this is by using the Khronos provided Docker image +`khronosgroup/docker-images:asciidoctor-spec` from DockerHub. +The Dockerfile specifying this image can be found at +https://github.com/KhronosGroup/DockerContainers[KhronosGroup/DockerContainers] +if you need to build a modified or layered image. Due to local and CI caching problems when this image +is updated on dockerhub, the OpenCL-Docs CI uses the SHA256 of the latest image update, +rather than the image name. + +Once you have installed all the dependencies you should be able to build both HTML +and PDF outputs for all specifications by: $ make