Merge pull request #2179 from keymanapp/developer-lexical-model-compiler-documentation

[Developer] Make lexical-model-compiler README slightly more user-centric.

developer/js/README.md

@@ -1,7 +1,7 @@
 Keyman Developer
 ================
 
-This contains the source code of Keyman development tools:
+This package provides the following Keyman **command line tools**:
 
  - `kmlmc` — takes **lexical model sources** and compiles them in to
    a **.js** file.
@@ -10,8 +10,8 @@ This contains the source code of Keyman development tools:
  - `kmlmi` — merges Keyman lexical model `.model_info` files.
 
 `kmlmc` is intended to be used standalone, or as part of a build system.
-`kmlmp` is used only by command line tools. `kmlmi` is used only in the
-[lexical-models repository](https://github.com/keymanapp/lexical-models).
+`kmlmp` is used only by command line tools. `kmlmi` is used exclusively
+in the [lexical-models repository][lexical models].
 
 In order to build [lexical models][], these tools must be built and
 compiled.
@@ -19,8 +19,28 @@ compiled.
 [lexical models]: https://github.com/keymanapp/lexical-models
 
 
-How to build
-------------
+Install
+-------
+
+Install `kmlmc`, `kmlmp`, and `kmlmi` globally:
+
+    npm install -g @keymanapp/lexical-model-compiler
+
+Usage
+-----
+
+To compile a lexical model from its `.model.ts` source, use `kmlmc`:
+
+    kmlmc my-lexical-model.model.ts --outFile my-lexical-model.js
+
+To see more command line options by using the `--help` option:
+
+    kmlmc --help
+    kmlmp --help
+    kmlmi --help
+
+How to build from source
+------------------------
 
 Run `build.sh`:
 
@@ -39,32 +59,3 @@ How to update the package version
 **NOTE**: this step should only be performed on the CI server:
 
     ./build.sh -version MAJOR.MINOR.${BUILD_NUMBER} [-tier (alpha|beta)]
-
-
-How to install
---------------
-
-This will install both `kmlmc` and will let you install the compiler in
-other node projects on your machine.
-
-    ./build.sh
-    npm link
-
-
-How to use in other Node projects
----------------------------------
-
-With the package installed with the above instructions, in your new
-project, link this package:
-
-
-    npm link @keymanapp/developer-lexical-model-compiler
-
-
-How to use on the command line
-------------------------------
-
-With the package installed with the above instructions, you can now run
-`kmlmc` (Keyman Lexical Model Compiler):
-
-    kmlmc <your model.ts file> -o <compiled lexical model>