Update README.md
format.
diff --git a/README.md b/README.md
index 5e47a9e..76a0e3d 100644
--- a/README.md
+++ b/README.md
@@ -30,45 +30,49 @@
- _**scancode**_ - Configurable code scanning utility that performs file and line-level checks on all files (exclusions permitted) on a provided path. It is intended for Git commit hooks and continuous integration (CI) builds to enforce certain coding conventions.
-If you "push" code that follows all conventions, you will see the message:
+If you "push" code that follows all conventions, you will see the message:
+```bash
Scanning files starting at [./mycodepath/]...
All checks passed.
-
+```
However, if you push code containing tabs, trailing whitespace or missing Apache License headers, your build will fail immediately with one of the following messages:
-
+```bash
Scan detected 3 error(s) in 1 file(s):
[./mycodepath/sourcecode.go]:
1: file does not include required license header.
18: line contains tabs.
27: line has trailing whitespaces.
+```
-To make sure this never happens to you, you can run the same tests on your local machine every time you commit changes.
+To make sure this never happens to you, you can run the same tests on your local machine every time you commit changes.
- Clone the OpenWhisk utilities project repo.:
-
+1. Clone the OpenWhisk utilities project repo.:
+```bash
$ git clone https://github.com/apache/incubator-openwhisk-utilities.git
+```
- Run the scancode utility against the root directory of your project or subdirectory where your code changes live:
-
+2. Run the scancode utility against the root directory of your project or subdirectory where your code changes live:
+```bash
# Invoke Python utility (works with either Python 2 or 3)
$ python ./incubator-openwhisk-utilities/scancode/scanCode.py $ROOTDIR
+```
-It is worth adding a Git pre-commit hook to automatically run the checks before you can even type in a Git commit message. Here is a sample pre-commit file:
+It is worth adding a Git [pre-commit hook](https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks) to automatically run the checks before you can even type in a Git commit message. Here is a sample `pre-commit` file:
+```bash
$ cat /path/to/openwhisk/.git/hooks/pre-commit
#!/usr/bin/env bash
# determine openwhisk base directory
root="$(git rev-parse --show-toplevel)"
python /path/to/incubator-openwhisk-utilities/scancode/scanCode.py . --config $root/tools/
+```
-Note: A hook a locally installed, so if you check out the repository again, you will need to reinstall it.
+_Note_: A hook a locally installed, so if you check out the repository again, you will need to reinstall it.
If your project repo. is new or does not run scancode yet, you can choose to create a "pre-build" Bash script that can be included in your Travis CI integration that includes code similar to Step 1 and 2. You can invoke this script within the ".travis.yml" file early in your install or build scripts.
-For full documentation on the scancode utility, please reference its README: https://github.com/apache/incubator-openwhisk-utilities/tree/master/scancode
-
### Issues
Report bugs, ask questions and request features [here on GitHub](../../issues).
