Update README.adoc

Author: simonhkswan

README.adoc

@@ -1,6 +1,14 @@
+:url-nodejs: https://nodejs.org/en/download/
+:url-nvm: https://github.com/nvm-sh/nvm
+:url-nvm-install: https://github.com/nvm-sh/nvm#installing-and-updating
+:url-gulp: https://gulpjs.com/docs/en/getting-started/quick-start
+:org: synthesized-io
+:project: docs-ui
+:repo: {org}/{project}
+
 = Synthesized Docs UI
 
-This repository contains the css and js files used for styling Synthesized's Docs [synthesized-io/synthesized-io.github.io](https://github.com/synthesized-io/synthesized-io.github.io). It produces a UI bundle that is referenced by the Antora documentation builder.
+This repository contains the css and js files used for styling Synthesized's Docs https://github.com/synthesized-io/synthesized-io.github.io[synthesized-io/synthesized-io.github.io]. It produces a UI bundle that is referenced by the Antora documentation builder.
 
 == Use the Default UI
 
@@ -20,19 +28,19 @@ If the URL were to be unique, this setting would not be required.
 
 Read on to learn how to customize the default UI for your own documentation.
 
-== Development Quickstart
+== Quickstart
 
 This section offers a basic tutorial to teach you how to set up the default UI project, preview it locally, and bundle it for use with Antora.
 A more comprehensive tutorial can be found in the documentation at {url-antora-docs}.
 
-=== Prerequisites
+=== 1. Prerequisites
 
 To preview and bundle the default UI, you need the following software on your computer:
 
 * {url-nodejs}[Node.js] (commands: `node` and `npm`)
 * {url-gulp}[Gulp CLI] (command: `gulp`)
 
-==== Node.js
+==== 1.1. Node.js
 
 Next, make sure that you have Node.js installed (which also provides npm).
 
@@ -57,7 +65,7 @@ To make Node.js 10 the default in new terminals, type:
 
 Now that you have Node.js installed, you can proceed with installing the Gulp CLI.
 
-==== Gulp CLI
+==== 1.2. Gulp CLI
 
 You'll need the Gulp command-line interface (CLI) to run the build.
 The Gulp CLI package provides the `gulp` command which, in turn, executes the version of Gulp declared by the project.
@@ -70,43 +78,19 @@ Verify the Gulp CLI is installed and on your PATH by running:
 
  $ gulp --version
 
-If you prefer to install global packages using Yarn, run this command instead:
-
- $ yarn global add gulp-cli
-
-Alternately, you can use the `gulp` command that is installed by the project's dependencies.
-
- $ $(npm bin)/gulp --version
-
 Now that you have the prerequisites installed, you can fetch and build the UI project.
 
-=== Clone and Initialize the UI Project
-
-Clone the default UI project using git:
+=== 2. Clone Repo and install dependencies
 
-[subs=attributes+]
- $ git clone {url-project} &&
-   cd "`basename $_`"
+[subs=attributes]
+ $ git clone https://github.com/{repo}
+ $ cd {project}
 
-The example above clones Antora's default UI project and then switches to the project folder on your filesystem.
-Stay in this project folder when executing all subsequent commands.
+Use npm to install the project’s dependencies inside the project. In your terminal, execute the following command:
 
-Use npm to install the project's dependencies inside the project.
-In your terminal, execute the following command:
+ $ npm i
 
- $ npm install
-
-This command installs the dependencies listed in [.path]_package.json_ into the [.path]_node_modules/_ folder inside the project.
-This folder does not get included in the UI bundle and should _not_ be committed to the source control repository.
-
-[TIP]
-====
-If you prefer to install packages using Yarn, run this command instead:
-
- $ yarn
-====
-
-=== Preview the UI
+=== 3. Preview the UI
 
 The default UI project is configured to preview offline.
 The files in the [.path]_preview-src/_ folder provide the sample content that allow you to see the UI in action.
@@ -132,7 +116,7 @@ This works by monitoring the project for changes, running the `preview:build` ta
 
 Press kbd:[Ctrl+C] to stop the preview server and end the continuous build.
 
-=== Package for Use with Antora
+=== 4. Package for Use with Antora
 
 If you need to package the UI so you can use it to generate the documentation site locally, run the following command:
 
@@ -171,7 +155,3 @@ Copyright (C) 2017-present OpenDevise Inc. and the Antora Project.
 
 Use of this software is granted under the terms of the https://www.mozilla.org/en-US/MPL/2.0/[Mozilla Public License Version 2.0] (MPL-2.0).
 See link:LICENSE[] to find the full license text.
-
-== Authors
-
-Development of Antora is led and sponsored by {url-opendevise}[OpenDevise Inc].