Readme update

Author: vcua-mobify

README.md

@@ -1,6 +1,6 @@
 # Raml Toolkit  <!-- omit in toc -->
 
-A collection of raml tools for commerce cloud and beyond
+A collection of raml an OAS tools for commerce cloud and beyond
 
   [![CircleCI][circleci-image]][circleci-url]
 
@@ -26,13 +26,42 @@ npm install -g @commerce-apps/raml-toolkit
 
 ## Usage
 
-The npm installs the binaries as both `raml-toolkit` and `ramlint` and they can be used interchangeably.  You can always run with `--help` to get available options, currently the options are as follows.
+Npm installs the binaries as both `raml-toolkit` and `ramlint` and they can be used interchangeably.  You can always run with `--help` to get available options, currently the options are as follows.
 
-### Commands
+## Commands
 
 **Note:** Some commands require environment variables to be set. This can be done using a [.env file](https://www.npmjs.com/package/dotenv#rules) in your working directory (the directory from which you run `raml-toolkit`).
 
-<!-- commands -->
+### Commands for OAS
+
+- [`raml-toolkit diff BASE NEW -s oas`](#raml-toolkit-diff-base-new-s-oas)
+- [`raml-toolkit download`](#raml-toolkit-download)
+
+#### `raml-toolkit diff BASE NEW -s oas`
+
+**Note:** This command requires that oasdiff is. installed. Install oasdiff according to https://github.com/oasdiff/oasdiff#installation
+
+USAGE
+  $ raml-toolkit diff BASE NEW -s oas
+
+ARGUMENTS
+  BASE  The base API spec file or directory
+  NEW   The new API spec file or directory
+
+OPTIONS
+  -f, --format=(json|console)                     Format of the output. Defaults to JSON if --out-file is specified,
+                                                  otherwise text.
+
+  -o, --out-file=out-file                         File to store the computed difference
+
+  --dir                                           Find the differences for files in two directory trees
+
+  -s, --spec                                      Toggles OAS mode. Set this to `oas`. Otherwise, the command will run the RAML version
+
+
+### Commands for RAML
+
+<!-- commands for RAML -->
 - [`raml-toolkit diff BASE NEW`](#raml-toolkit-diff-base-new)
 - [`raml-toolkit download`](#raml-toolkit-download)
 - [`raml-toolkit lint [FILENAME]`](#raml-toolkit-lint-filename)

src/diff/oasDiff.ts

@@ -17,7 +17,7 @@ import { execSync } from "child_process";
 async function _saveOrLogOas(changes: string, flags): Promise<void> {
   const file = flags["out-file"];
   if (file) {
-    console.log("Saving results to file");
+    console.log(`API Changes found! Saving results to file ${file}`);
     if (flags.format === "json") {
       console.log("Using json format");
       await fs.writeJson(file, JSON.parse(changes));