General Naming Conventions
- It's a good idea to keep the names all lowercase.
- Keep it prompt so it's easy to read.
- Try using "-" or "-" instead of spaces.
You don't have to follow these suggestions but it helps over time. If nothing else, remember to keep it consistent to avoid headaches.
Questions
Question names usually correlate to the question being asked of the user, but it doesn't need to be the whole sentence. It can be just a snippet of the text or a single keyword from the question. For example, imagine you want to have a question that answers common questions such as "What's the best place to eat in Denver?." A good title might be food or dinner. If you have several locations you need to be able to answer that question for, you might try food-denver or dinner-denver. You want to be able to distinguish the question from other questions while keeping the name short.
Sometimes, you may have questions that have questions within them, or sub questions. In that case, follow the same rules for questions, but add the top question in front of it. So, question-1.question-2 and so forth. Following this naming convention makes it easy to understand the flow of the bot and how it will work.
Intents
Global intents should follow similar naming conventions to that of questions. Short, simple, and easy to understand. When you have an intent that is specific to a question however, you want follow a different set of guidelines. The easiest way to tell that an intent "belongs" to a question is to name it name-of-question.name-of-intent. This helps avoid confusion.
Take for example, selling clothes. If you had blue pants and blue shirts, you might end up with two duplicate intents called blue and blue. To avoid this, you should call one intent pants.blue and the other shirts.blue. This lets you instantly see which intents belong to which question in the drop-down menu, and makes filtering though intents much easier.
Use this as a guide for building the names of your intents: question.any-sub-question.any-intents