README.adoc in asciidoctor-csd-0.2.8 vs README.adoc in asciidoctor-csd-0.3.1

@@ -47,10 +47,22 @@
 check that they have provided all necessary components of the
 document.
 
 The gem then converts the XML into HTML and PDF.
 
+=== Installation
+
+If you are using a Mac, the https://github.com/riboseinc/metanorma-macos-setup
+repository has instructions on setting up your machine to run Metanorma
+scripts such as this one. You need only run the following in a Terminal console:
+
+[source,console]
+----
+$ bash <(curl -s https://raw.githubusercontent.com/riboseinc/metanorma-macos-setup/master/metanorma-setup)
+$ gem install asciidoctor-csd
+----
+
 === PDF output
 
 PDF output is generated by printing the HTML output as PDF. This is done
 within the gem, using 
 https://developers.google.com/web/updates/2017/04/headless-chrome[Headless Chrome],
@@ -60,9 +72,12 @@
 
 * Install Node, with at least version 7.6.0: https://nodejs.org/en/download/,
 https://nodejs.org/en/download/package-manager/ . (For Mac, `brew install node`)
 * Install npm: https://docs.npmjs.com/getting-started/installing-node
 * Install puppeteer: `npm install -g --save --save-exact puppeteer`
+
+The https://github.com/riboseinc/metanorma-macos-setup script includes Puppeteer
+installation.
 
 == Approach
 
 === Document model