Update navigation.md

docs/howtos/navigation.md

@@ -2,52 +2,83 @@
 
 So, after nailing the part where the chatbot speaks - the “Say” - now we go to the **Navigation **- the part in the conversation when the user speaks.
 
+![alt_text](nav_intents.png "image_tooltip")
+
 Our role, as conversation designers, is to smoothly lead the user into saying what we planned (Happy Path). Generally, as in life in general, we need to be prepared for anything.
 
 ## 1. Left-click on the canvas and click on the navigation node
 
-![alt_text](nav2.png "image_tooltip")
+![alt_text](nav_basic.png "image_tooltip")
 
-Navigation nodes can be operated in two ways: Intents and Keywords.
+So, intents are collections of semantically similar utterances that basically mean the same thing in a conversation. For example, “Yes” is a word, but “Yeah!”, “Sure”, “YESSS” and “Yup” also mean the same thing, and we should embrace them as well.
 
-## 2. 1. Intents
+On CoCoHub’s studio, we have plethora of intents - in which you only need to write the answers: Conversation basics (Hi, Bye, Yes, No...), Customer Service musts (Opening hours, prices, locations...), Emotions, Small talk, etc.
 
-So, intents are collections of semantically similar utterances that basically mean the same thing in a conversation. For example, “Yes” is a word, but “Yeah!”, “Sure”, “YESSS” and “Yup” also mean the same thing, and we should embrace them as well.
+## 2. Click “Add an intent” and a menu will pop up. 
 
-On CoCoHub’s studio, we have 5 intents - click on the needed one
+![alt_text](nav_basic.png "image_tooltip")
 
-Yes - the user answers in a positive way
+- Type your desired intent in the search window, or
+- Scroll down and up, up and down, until you find something fitting. 
 
-No - the user answers in a negative way
+Once you hover with the mouse over the intent, you’ll see what it does and some examples of relevant inputs. 
 
-![alt_text](nav1.png "image_tooltip")
+Now, by clicking on the eye button, you can get inside and see the complete variety of phrases and utterances.
 
-Continue - the user asks the chatbot to go on
+To create your own intent, click the “Make your own” link or the “Create” button - and an intent creation menu will appear. 
 
-Stop - the user asks the chatbot to abort the conversation
+![alt_text](nav_create.gif "image_tooltip")
 
-![alt_text](nav7.png "image_tooltip")
+nav_create_learned1.gif
 
-Wildcard - an option in which every input by the user is valid, and yields the same response. What is it good for? Here are two examples:
+Now you have two kinds of intents: Learned (ML-based) and Keywords.
 
--   When you need the user’s opinion or answer for data-collection purposes - and the scope of answers is too wide (“What’s your favourite travel destination in the world?”)
+## 2. 1. Learned Intents
 
--   When you don’t really need the user’s data at that point - but you want to make the user feel involved and engaged (“How was your day?”)
+- Give the intent a name, that reflects the intent’s purpose or essence.
+
+- Click “Add first phrase”, then add relevant phrases. Press “Enter” to move to a new phrase. You can always delete existing phrases. You don't have to list every possible way of saying what you want - it's ML-based after all.
+
+![alt_text](nav_create_learned1.gif "image_tooltip")
+
+- Open “Publishing settings”, and add some relevant tags (such as “customer service”, “small talk”, “name”, etc) that will help in finding your chatbots' intents
+
+- Add a description - a short explanation on the intent’s purpose (“User tries to…”)
+
+- If the intent is specific for your purpose, business or use case, just click “save” and it’s saved. If you think it’s useful enough for all our community, click on “publish request” and we’ll review it - if it’s good enough, you’ll have your own intent in the hub.
+
+![alt_text](nav_create_learned2.gif "image_tooltip")
 
-## 2. 2. Keywords
+## 2. 2. Keyword Intents
 
-Keywords are the way to go when you expect the user to answer with a specific word, sentence or phrase; if the user won’t respond with these words, the conversation can be unfruitful.
+If you want to provide specific answers to specific keywords - just choose the keyword intent.
 
-For example, if you have a pet shop and you serve only people with dogs, cats and fish (which covers almost 99% of the pets owned in the USA), your chatbot can relate only to those people and filter out all the rest.
+- Give the intent a name, that reflects the intent’s purpose or essence.
 
-With keyword, you can design a different flow for every keyword or phrase
+- Enter all relevant keywords that will be answered identically 
 
-![alt_text](nav5.png "image_tooltip")
+![alt_text](nav_keywords1.gif "image_tooltip")
 
-Or put all of them in the same keywords space, if you want to have the same flow from there onwards for all those keywords.
+- Go to “Publishing settings” - add tags that will help you in finding your chatbots' keywords
+
+- Add a description - a short explanation on the intent’s purpose (“User talks about…”)
+
+- Click "Save"
+
+After finishing, don't forget to match specific answers to those keywords
+
+![alt_text](nav_keywords2.gif "image_tooltip")
+
+
+## 2. 3. "Anything Else"
+
+Anything else: Every option that the users says outside the scope of conversation you designed. It can also be useful...
+
+-   When you need the user’s opinion or answer for data-collection purposes - and the scope of answers is too wide (“What’s your favourite travel destination in the world?”)
+
+-   When you don’t really need the user’s data at that point - but you want to make the user feel involved and engaged (“How was your day?”)
 
-![alt_text](nav8.png "image_tooltip")
 
 ### CoCo Tip
 
-If you’re choosing keywords, make sure you put all the relevant words and synonyms there, so you won’t miss anything that can fit - for example, if you write “cat” as an option, make sure you have “cats” and “feline” there too.
+If you’re choosing keywords, make sure you put all the relevant words, synonyms and even popular typos there, so you won’t miss anything that can fit - for example, if you write “cat” as an option, make sure you have “cats” and “feline” there too.