Merge branch 'master' into vishwac/model-as-feature

Author: munozemilio

packages/luis/docs/create-luis-json.md

@@ -0,0 +1,31 @@
+# Creating LUIS JSON model file
+
+Once you have created individual .lu files you can parse them all to a LUIS JSON model using this command: 
+```bash
+> bf luis:convert --in <folder with .lu files> --out <outputfolder> --name <luisAppName> --culture <luisAppCulture>]
+```
+
+This will parse all .lu files found and will create **ONE** LUIS JSON model. 
+
+If you would like to create multiple luis apps, then you can add a [root.lu file](../examples/en-us/root.lu) that holds reference to other relevant .lu files and parse it like this: 
+
+```bash
+> bf luis:convert --in <root_file.lu> [--out <outputFolder> --name <luisAppName> --culture <luisAppCulture>]
+```
+
+This will parse all .lu files referenced in the root_file.lu and output **ONE** LUIS JSON model. 
+
+# Creating a New LUIS App
+## using command line 
+You can use the new LUIS JSON file to create a new LUIS application using this command.
+```bash
+luis import application --in _LUISApp.json --authoringKey "" --endpoint ""
+```
+Note: You can install LUIS CLI from [here](../../LUIS). If you are using LUIS CLI, you might see the option to provide a versionId, application name directly in the LUIS CLI. You can also provide this information to the Ludown tool to generate your LUIS JSON model as well. Information explicitly specified in the LUIS CLI will override any information captured by Ludown tool. 
+
+## using [LUIS](http://luis.ai) portal
+- Navigate to [LUIS](http://luis.ai)
+- Sign in
+- Click on My apps
+- "Import new App"
+- Choose file -> select the _LUISApp.json generated by LUDown tool

packages/luis/docs/create-qna-json.md

@@ -0,0 +1,38 @@
+# Creating QnA Maker JSON model file
+
+Once you have created individual .lu files you can parse them all to a QnA Maker JSON model using this command: 
+```bash
+> bf qnamaker --in <folder with .lu files> [--out <outputfolder> --name <QnAKBName>]
+```
+
+This will parse all .lu files found and will create **ONE** QnA Maker JSON model. 
+
+If you would like to create multiple QnA Maker KB's, then you can add a [root.lu file](../examples/en-us/root.lu) that holds reference to other relevant .lu files and parse it like this: 
+
+```bash
+> bf qnamaker --in <root_file.lu> [-o <outputFolder> -n <QnAKBName> --log]
+```
+
+This will parse all .lu files referenced in the root_file.lu and output **ONE** QnA Maker JSON model. 
+
+# Creating word alterations/ synonyms list
+You can use ludown to parse and compile all word alterations/ synonyms list that can then be used to replace your existing [QnA Maker alterations](https://westus.dev.cognitive.microsoft.com/docs/services/5a93fcf85b4ccd136866eb37/operations/5ac266295b4ccd1554da75fd) list. 
+
+See [here](lu-file-format.md#QnA-Maker-alterations) for defining word alterations/ synonyms list in .lu files.
+
+```bash
+> bf qnamaker --alterations --in <root_file.lu> [-o <outputFolder> -n <QnAKBName> --log]
+```
+
+# Creating a new QnAMaker KB
+
+```bash
+> bf qnamaker:create:kb --in _qnaKB.json --subscriptionKey <key> --hostname <url> --endpointKey <key>
+```
+
+# Replacing QnA Maker word alterations/ synonyms list
+
+```bash
+> qnamaker:replace:alterations --in _Alterations.json --subscriptionKey <key> --hostname <url> --endpointKey <key>
+```
+