Skip to content
Closed
Changes from 1 commit
Commits
Show all changes
4361 commits
Select commit Hold shift + click to select a range
02f98c4
Update bot-builder-howto-proactive-message.md
JonathanFingold Nov 24, 2020
d6a8621
Update bot-builder-howto-proactive-message.md
JonathanFingold Nov 24, 2020
95110a2
Create bot-service-debug-adaptive-tool.md
Nov 25, 2020
affb1dc
Added links to debug with adaptive tool article
Nov 25, 2020
dce5ad1
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
Nov 25, 2020
fc4caf6
Update bot-service-debug-adaptive-tool.md
Nov 25, 2020
92aba15
Update bot-service-debug-adaptive-tool.md
Nov 25, 2020
2d11e03
Update bot-builder-howto-proactive-message.md
JonathanFingold Nov 25, 2020
3988e31
Fix typo
JonathanFingold Nov 30, 2020
9243ab7
Fixed content.
Nov 30, 2020
6d68a57
Update bot-service-channel-directline-extension-net-bot.md
Nov 30, 2020
f175cdd
Incoroporate John's feedback
JonathanFingold Dec 1, 2020
01cb348
Update bot-service-debug-adaptive-tool.md
Dec 1, 2020
ecae3e7
Update bot-service-debug-adaptive-tool.md
Dec 1, 2020
ff44324
Update bot-service-debug-adaptive-tool.md
Dec 1, 2020
429eab8
Update TOC.yml
Dec 1, 2020
0dd6b82
Update adaptive-expressions-prebuilt-functions.md
Dec 1, 2020
ce56814
Update adaptive-expressions-prebuilt-functions.md
Dec 1, 2020
53dac95
Address John's feedback
JonathanFingold Dec 1, 2020
f0d0399
Merge pull request #2481 from MicrosoftDocs/jf/proactive-1124
JonathanFingold Dec 1, 2020
6539c51
Merge branch 'master' into mm-bot-issue-1958
JonathanFingold Dec 1, 2020
7d9e41b
Merge pull request #2483 from MicrosoftDocs/mm-bot-issue-1958
JonathanFingold Dec 1, 2020
450249a
Added image and fixed content to explain trusted origins based on a d…
Dec 2, 2020
2d3b6e8
Chnaged new articel title and fixed related links.
Dec 2, 2020
ee65032
Fixed based on CK feedback
Dec 2, 2020
88505de
Update C# quickstart post R11
JonathanFingold Dec 2, 2020
0ae142d
Merge branch 'master' into mm-bot-enhanced-dl-oauth
JonathanFingold Dec 2, 2020
8ac390b
Update bot-service-resources-faq-security.md
Dec 2, 2020
e9a443e
Merge branch 'mm-bot-enhanced-dl-oauth' of https://github.com/Microso…
Dec 2, 2020
a02ba1f
Fix links
JonathanFingold Dec 2, 2020
f4f1c70
fix more links
JonathanFingold Dec 2, 2020
281755c
Fix one more link
JonathanFingold Dec 2, 2020
d0fc089
Update bot-service-resources-faq-security.md
Dec 2, 2020
f3edb4a
Merge pull request #2485 from MicrosoftDocs/jf/cs-templates-r11
JonathanFingold Dec 3, 2020
bb41ac0
Added new FAQ entry
Dec 3, 2020
1e1318b
Apply suggestions from code review
Dec 3, 2020
bbc675c
Update bot-builder-security-enhanced.md
Dec 3, 2020
2bd19f9
Merge branch 'mm-bot-enhanced-dl-oauth' of https://github.com/Microso…
Dec 3, 2020
bad7037
Merge branch 'master' into mm-bot-enhanced-dl-oauth
JonathanFingold Dec 3, 2020
a7be994
Merge pull request #2472 from MicrosoftDocs/mm-bot-enhanced-dl-oauth
JonathanFingold Dec 3, 2020
c002b7b
Update bot-service-channel-connect-directline.md
Dec 3, 2020
7af0ead
Update bot-service-channel-connect-directline.md
Dec 3, 2020
a4f3a37
Update bot-service-channel-connect-directline.md
Dec 3, 2020
a8d2440
Removed link syntax.
jdmartinez36 Dec 4, 2020
a1144e5
Merge pull request #2488 from MicrosoftDocs/mm-bot-enhanced-auth-adde…
JonathanFingold Dec 7, 2020
9a8f237
Merge branch 'master' into mm-bot-add-faq-entry
JonathanFingold Dec 7, 2020
2b7ce5c
Fix various issues
JonathanFingold Dec 7, 2020
56ece5b
Merge pull request #2490 from MicrosoftDocs/jf/telemetry-1207
JonathanFingold Dec 7, 2020
82bea80
Updated links to cross-repo.
jdmartinez36 Dec 7, 2020
5386501
Merge branch 'master' into linksyntaxbranch
JonathanFingold Dec 7, 2020
052ccc7
Added new troubleshooting entry
Dec 7, 2020
3da756f
Merge pull request #2489 from jdmartinez36/linksyntaxbranch
JonathanFingold Dec 7, 2020
674b520
Fixed title
Dec 7, 2020
01540f6
Update TOC.yml
Dec 8, 2020
9cf71fb
Update TOC.yml
Dec 8, 2020
a7fc422
Update bot-service-resources-faq-general.md
Dec 8, 2020
1a8ce7a
Update bot-builder-howto-add-media-attachments.md
Dec 9, 2020
172a646
Update bot-builder-howto-add-media-attachments.md
Dec 9, 2020
e26ac0c
Merge pull request #2492 from MicrosoftDocs/mm-bot-security-toc-impro…
JonathanFingold Dec 9, 2020
866233b
Merge branch 'master' into mm-bot-add-faq-entry
JonathanFingold Dec 9, 2020
0ae72c9
Merge pull request #2486 from MicrosoftDocs/mm-bot-add-faq-entry
JonathanFingold Dec 9, 2020
0f2ddfb
fixed link to iso 8601 wiki page
Dec 9, 2020
0f162c3
Update bot-service-troubleshoot-general-problems.md
Dec 9, 2020
c1aef89
Add installation update info
JonathanFingold Dec 9, 2020
e968301
fix link
JonathanFingold Dec 9, 2020
67ad040
Update articles/bot-service-troubleshoot-general-problems.md
Dec 9, 2020
bc196f9
Merge pull request #2493 from MicrosoftDocs/jf/activity-handler-1209
JonathanFingold Dec 9, 2020
f47b378
Update bot-service-channel-connect-email.md
Dec 9, 2020
3820988
Update bot-service-channel-connect-email.md
Dec 9, 2020
c9c2a65
Update bot-service-channel-connect-email.md
Dec 10, 2020
5138dc7
Update snippet-channeldata.md
Dec 10, 2020
076f43a
Update bot-service-channel-connect-email.md
Dec 10, 2020
056fb96
Fixed include file, shared this file . fixed content
Dec 11, 2020
468185a
Update snippet-channeldata.md
Dec 11, 2020
dd9b338
Fixed content
Dec 11, 2020
8ae2653
Fixed content
Dec 11, 2020
1ef8bb6
Update snippet-channelData-email.md
Dec 11, 2020
4f56d9b
Merge branch 'master' into v-emolsh/issue-fix/bot-docs-1927
Dec 11, 2020
cfe6cdb
Fixed content based on feedback. Added images.
Dec 14, 2020
fef2b0b
Update bot-service-troubleshoot-general-problems.md
Dec 14, 2020
421acd3
Update bot-service-troubleshoot-general-problems.md
Dec 14, 2020
3668090
Fixed content and added a couple of supporting images.
Dec 15, 2020
1e6ff41
Fixed image
Dec 15, 2020
c641291
Merge branch 'master' into mm-email-channeldata-schema
JonathanFingold Dec 15, 2020
b8bff07
Update bot-service-channel-directline.md
Dec 15, 2020
8f0a135
Merge pull request #2494 from MicrosoftDocs/mm-email-channeldata-schema
JonathanFingold Dec 16, 2020
3ec0db8
Merge branch 'master' into v-emolsh/issue-fix/bot-docs-1927
JonathanFingold Dec 16, 2020
f0ebaf4
Merge pull request #2484 from MicrosoftDocs/v-emolsh/issue-fix/bot-do…
JonathanFingold Dec 16, 2020
c2ac006
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
Dec 16, 2020
16889e5
Update bot-service-channel-directline.md
Dec 16, 2020
976b5b1
Update bot-framework-rest-connector-api-reference.md
Dec 17, 2020
9599a39
Merge branch 'master' into mm-bot-dl-speech
JonathanFingold Dec 17, 2020
23330a5
Merge pull request #2497 from MicrosoftDocs/mm-bot-dl-speech
JonathanFingold Dec 17, 2020
68b9929
Added images and fixed content.
Dec 17, 2020
c78ad6c
Update articles/rest-api/bot-framework-rest-connector-api-reference.md
Dec 17, 2020
80304bf
Update directline-speech-bot.md
Dec 17, 2020
9aaa7ea
Merge branch 'master' into mm-bot-rest-api-http-status-codes
JonathanFingold Dec 17, 2020
8605f4a
Merge pull request #2498 from MicrosoftDocs/mm-bot-rest-api-http-stat…
JonathanFingold Dec 17, 2020
be2025d
Update bot-service-overview-introduction.md
Dec 18, 2020
9bd62b9
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
JonathanFingold Dec 18, 2020
732b15a
Update articles/bot-service-troubleshoot-general-problems.md
Dec 21, 2020
fb62147
Apply suggestions from code review
Dec 21, 2020
43ffc41
Update bot-service-troubleshoot-general-problems.md
Dec 21, 2020
d9ad673
Merge branch 'mm-bot-test-network-connectivity' of https://github.com…
Dec 21, 2020
09039e4
Update bot-service-troubleshoot-general-problems.md
Dec 21, 2020
91dd6e8
Merge branch 'master' into mm-bot-channel-fb
Dec 21, 2020
c440d16
Apply suggestions from code review
Dec 21, 2020
739c190
Update bot-builder-lu-file-format.md
Dec 21, 2020
f308a6f
Merge branch 'master' into mm-bot-test-network-connectivity
JonathanFingold Dec 21, 2020
a07332d
Merge pull request #2491 from MicrosoftDocs/mm-bot-test-network-conne…
JonathanFingold Dec 21, 2020
aa0e66e
Apply suggestions from code review
Dec 21, 2020
304c97a
Update quickstart-dotnet-prerequisites.md
Dec 21, 2020
3959188
Update snippet-deploy-without-bot.md
Dec 22, 2020
a01efd5
Fixed typos.
Dec 22, 2020
2a589d7
Update bot-service-channel-directline-extension.md
Dec 22, 2020
05568f2
Update bot-service-channel-connect-facebook.md
Dec 22, 2020
37fd2da
Update bot-service-design-user-experience.md
Dec 22, 2020
ba1dd2f
Merge branch 'master' into mm-bot-channel-fb
JonathanFingold Dec 22, 2020
4f350f6
Merge pull request #2496 from MicrosoftDocs/mm-bot-channel-fb
JonathanFingold Dec 22, 2020
2732d48
Update bot-builder-webchat-overview.md
Dec 22, 2020
269112d
Update bot-builder-webchat-overview.md
Dec 23, 2020
0b7deaa
Merge branch 'master' into v-emolsh/issue-fix/bot-docs-1969
Dec 23, 2020
8aa21f1
Update bot-builder-webchat-overview.md
Dec 23, 2020
09cfa28
Moved v3 section to FAQ article
Dec 23, 2020
7ee8429
Update contributor-guide-index.md
JonathanFingold Dec 23, 2020
db93632
Merge branch 'master' into mm-bot-fix-issues
JonathanFingold Dec 23, 2020
7adb045
Merge pull request #2499 from MicrosoftDocs/mm-bot-fix-issues
JonathanFingold Dec 23, 2020
9f49cc5
Add GitHub tips and tricks article
JonathanFingold Dec 23, 2020
29bd5e2
Added links in the index page and organized content
Dec 23, 2020
85c52c2
Update bot-service-resources-bot-framework-faq.md
Dec 23, 2020
8320fc5
Update bot-builder-webchat-overview.md
Dec 23, 2020
7756a4b
Merge branch 'master' into mm-bot-webchat-cleanup
Dec 23, 2020
f1b622b
Added links fixed wording
Dec 23, 2020
9b2de96
Merge branch 'mm-bot-webchat-cleanup' of https://github.com/Microsoft…
Dec 23, 2020
5b0615f
Merge branch 'master' into jf/contrib-1223
JonathanFingold Dec 23, 2020
c3d787d
Update bot-builder-webchat-overview.md
Dec 23, 2020
84ea173
Merge pull request #2502 from MicrosoftDocs/jf/contrib-1223
JonathanFingold Dec 23, 2020
9f2f37c
Add messageBack to table, convert table to snippet
JonathanFingold Dec 23, 2020
2c98bde
Fixed content
Dec 23, 2020
f9148cc
Update snippet-card-action-types.md
JonathanFingold Dec 23, 2020
3d5c627
Merge branch 'master' into v-emolsh/issue-fix/bot-docs-1969
Dec 23, 2020
51009d2
Changed AKA links to relative path or site-relative link.s
WashingtonKayaker Dec 23, 2020
9ddee5b
Merge pull request #2500 from MicrosoftDocs/v-emolsh/issue-fix/bot-do…
JonathanFingold Dec 23, 2020
6c890bd
Merge branch 'master' into jf/messageBack
Dec 23, 2020
4e171dc
Merge branch 'live' into master
JonathanFingold Dec 23, 2020
772e2fe
Update what-is-new-archive.md
WashingtonKayaker Dec 23, 2020
d9966e0
Merge branch 'master' into SM-AKA-Link-Conversion
WashingtonKayaker Dec 23, 2020
2a5af38
link issues
WashingtonKayaker Dec 24, 2020
95e98c9
minor updates to fix checkin validation warnings.
WashingtonKayaker Dec 24, 2020
cb15f3f
Update articles/includes/snippet-card-action-types.md
JonathanFingold Dec 24, 2020
2e7f761
Fix random typos.
JonathanFingold Dec 24, 2020
5a8649d
Merge branch 'jf/messageBack' of https://github.com/MicrosoftDocs/bot…
JonathanFingold Dec 24, 2020
ba41064
Merge branch 'master' into jf/messageBack
JonathanFingold Dec 24, 2020
77b32f0
Merge pull request #2503 from MicrosoftDocs/jf/messageBack
JonathanFingold Dec 24, 2020
01d4338
Fix more typos
JonathanFingold Dec 24, 2020
6a10e1e
Merge pull request #2506 from MicrosoftDocs/jf/fixes-for-live-sync-1223
JonathanFingold Dec 24, 2020
8c1f668
Merge pull request #2505 from MicrosoftDocs/master
JonathanFingold Dec 24, 2020
a932bb4
Changed Adaptive Tool --> Adaptive Tools
Dec 27, 2020
5fca27f
changed tool --> tools in file name and related files
Dec 27, 2020
9144b3c
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
Dec 27, 2020
6111183
Update bot-service-resources-faq-availability.md
Dec 28, 2020
2dbe436
Apply suggestions from code review
Dec 28, 2020
070953c
Update articles/file-format/bot-builder-lg-file-format.md
Dec 28, 2020
d93d165
Update bot-service-resources-faq-availability.md
Dec 28, 2020
9ed9669
Merge branch 'mm-bot-webchat-cleanup' of https://github.com/Microsoft…
Dec 28, 2020
a9c2b9c
Update articles/bot-service-resources-faq-availability.md
Dec 28, 2020
d1ba2e4
removed references to lg and lu
Dec 28, 2020
fc318d4
Update bot-service-resources-faq-availability.md
Dec 28, 2020
e9b7229
Merge branch 'mm-bot-webchat-cleanup' of https://github.com/Microsoft…
Dec 28, 2020
c1dafaa
Update bot-service-resources-bot-framework-faq.md
Dec 28, 2020
b7739ce
Merge branch 'master' into mm-bot-webchat-cleanup
JonathanFingold Dec 28, 2020
e86dda6
Fix for bot-docs issue 1987
JonathanFingold Dec 28, 2020
f2a0234
Merge pull request #2501 from MicrosoftDocs/mm-bot-webchat-cleanup
JonathanFingold Dec 28, 2020
9504b15
Update bot-framework-rest-connector-api-reference.md
JonathanFingold Dec 28, 2020
1ca039d
Fixed quotes
Dec 28, 2020
904c968
Fixed quotes
Dec 28, 2020
06a893d
Update security-baseline.md
Dec 28, 2020
ca0215a
Update security-baseline.md
Dec 28, 2020
c2bb209
Update bot-service-design-pattern-knowledge-base.md
Dec 29, 2020
93f241d
Update bot-service-design-pattern-knowledge-base.md
Dec 29, 2020
a2046f3
Update bot-service-design-navigation.md
Dec 29, 2020
e168989
Update bot-service-manage-settings.md
Dec 29, 2020
007eb9a
Fixed alt-text
Dec 29, 2020
79753f9
Update bot-builder-telemetry.md
Dec 29, 2020
c4ef222
fix missing pdf template (#2511)
herohua Dec 29, 2020
98511a5
Merge branch 'master' into jf/http-status-codes
JonathanFingold Dec 29, 2020
6358213
Merge pull request #2507 from MicrosoftDocs/jf/http-status-codes
JonathanFingold Dec 29, 2020
90ee6bc
Merge branch 'master' into mm-wht-alt-text
JonathanFingold Dec 29, 2020
bfc6ccb
Merge pull request #2510 from MicrosoftDocs/mm-wht-alt-text
JonathanFingold Dec 29, 2020
85ff1e7
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
Dec 29, 2020
006460a
Update articles/bot-service-channel-connect-directlinespeech.md
WashingtonKayaker Dec 29, 2020
41829f1
Minor updates to bot-builder-telemetry-qnamaker.md
WashingtonKayaker Dec 29, 2020
6b9081a
Merge branch 'SM-AKA-Link-Conversion' of https://github.com/Microsoft…
WashingtonKayaker Dec 29, 2020
963aa65
Apply suggestions from code review
Dec 29, 2020
3673250
Update security-baseline.md
Dec 29, 2020
17e0e58
Merge branch 'mm-wht-curly-quotes' of https://github.com/MicrosoftDoc…
Dec 29, 2020
9b16054
Apply suggestions from code review
Dec 29, 2020
4b58e40
Feedback incorporated.
WashingtonKayaker Dec 29, 2020
a85a80e
fixed link
WashingtonKayaker Dec 29, 2020
e5346ee
Update articles/includes/bot-service-debug-bot/python-vscode.md
WashingtonKayaker Dec 29, 2020
e66acf1
Update articles/includes/telemetry-javascript-main.md
WashingtonKayaker Dec 29, 2020
7da4937
Update articles/includes/telemetry-dotnet-main.md
WashingtonKayaker Dec 29, 2020
9a2ec8b
Update articles/includes/telemetry-dotnet-main.md
WashingtonKayaker Dec 29, 2020
d264e21
Update bot-builder-concept-adaptive-dialog-generators.md
WashingtonKayaker Dec 29, 2020
27a0233
Merge branch 'SM-AKA-Link-Conversion' of https://github.com/Microsoft…
WashingtonKayaker Dec 29, 2020
f71f12a
Merge branch 'master' into SM-AKA-Link-Conversion
JonathanFingold Dec 29, 2020
822d31e
Merge pull request #2504 from MicrosoftDocs/SM-AKA-Link-Conversion
JonathanFingold Dec 29, 2020
ff8cf6e
Merge branch 'master' into mm-wht-curly-quotes
JonathanFingold Dec 29, 2020
a0dbc7d
Merge pull request #2509 from MicrosoftDocs/mm-wht-curly-quotes
JonathanFingold Dec 29, 2020
48876f9
Update contributor-guide-pr-criteria.md
Dec 29, 2020
24ebd42
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
Dec 30, 2020
ca8ff44
Merge branch 'master' into mm-wht-curly-quotes-internal-guides
JonathanFingold Dec 30, 2020
f783886
Merge pull request #2508 from MicrosoftDocs/mm-wht-curly-quotes-inter…
JonathanFingold Dec 30, 2020
ab76289
Merge branch 'master' into v-emolsh/11-2020/debug-adaptive-tool
JonathanFingold Dec 30, 2020
a2d121c
Merge pull request #2482 from MicrosoftDocs/v-emolsh/11-2020/debug-ad…
JonathanFingold Dec 30, 2020
d140516
Update quickstart-python-prerequisites.md
Dec 31, 2020
6edd49e
Merge pull request #2514 from MicrosoftDocs/v-emolsh/issue-fix/bot-do…
JonathanFingold Jan 4, 2021
1b9bd37
mm-wht-here-links (#2515)
Jan 5, 2021
401f28c
Issue 1982 fix - replace unowned AKA links (#2516)
Jan 6, 2021
7b5b341
Add a text formatting article to the local contributors guide (#2517)
JonathanFingold Jan 7, 2021
776c4fd
Fixed broken link (#2520)
WashingtonKayaker Jan 7, 2021
c205c08
Fixed file extention formating for .lu, .lg, .qna (#2522)
WashingtonKayaker Jan 7, 2021
bd137fe
Fixed file extension formatting for .lu, .lg, .qna in all remaining f…
WashingtonKayaker Jan 7, 2021
20b5d95
zxyanliu-grammar-pass (1/4) (#2524)
zxyanliu Jan 11, 2021
03dbf3f
Grammar, tone, spelling, and typography pass (jf: 1/x) (#2512)
JonathanFingold Jan 11, 2021
3e20411
Changes to grammar and formatting, with minor technical changes. (#2525)
WashingtonKayaker Jan 11, 2021
bcdacac
Update bot-builder-howto-cross-train.md (#2473)
WashingtonKayaker Jan 12, 2021
dcb546e
mm-wht-doc-cleanup-01 (#2518)
Jan 12, 2021
4fe19f0
Grammar pass on bot-builder-dotnet-sdk-quickstart (#2530)
WashingtonKayaker Jan 12, 2021
9efc030
Merge branch 'master' of https://github.com/MicrosoftDocs/bot-docs-pr…
v-alje Jan 12, 2021
35f1084
Moving reference to new repo
v-alje Jan 12, 2021
2ca38ab
Fixing invalid json
v-alje Jan 12, 2021
b6275a0
mm-bot-snippet-update (#2527)
Jan 12, 2021
4e58702
mm-wht-writers-faqs (#2513)
Jan 12, 2021
b4ed2f2
mm-wht-public-faqs (#2519)
Jan 12, 2021
b62a465
Update TOC.yml (#2539)
Jan 13, 2021
e80161b
Update bot-framework-glossary.md (#2521)
JonathanFingold Jan 13, 2021
9947e63
Merge branch 'master' into smoke-test
v-alje Jan 13, 2021
4bdf31c
Merge pull request #2537 from MicrosoftDocs/smoke-test
v-alje Jan 14, 2021
f06b02b
Port Artur's changes to the bot-docs-pr repo. (#2534)
JonathanFingold Jan 14, 2021
e523d1d
zxyanliu/grammar pass 2/4 (#2536)
zxyanliu Jan 14, 2021
7465e57
TIP on handling the "none" intent (#2495)
WashingtonKayaker Jan 14, 2021
9a85232
Formatting text guide updates (#2546)
Jan 15, 2021
cf132ae
Incorporate fixes from bot-docs PRs. (#2543)
JonathanFingold Jan 15, 2021
acafa55
mm-wht-writers-faqs (#2544)
Jan 19, 2021
c12209d
Merge branch 'live' into master
v-alje Jan 19, 2021
aa5cc17
Merge pull request #2549 from MicrosoftDocs/master
v-alje Jan 19, 2021
662e41d
Release 'live' 01-20-2021 (#2551)
JonathanFingold Jan 22, 2021
7e32468
Initialize Docs repository: https://github.com/MicrosoftDocs/bot-docs…
v-alje Jan 26, 2021
22a92bc
Release 'live' 02-11-2021 (#2587)
JonathanFingold Feb 12, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Changes to grammar and formatting, with minor technical changes. (#2525)
* Changes to grammar and formatting, with minor technical changes.

Aside from grammatical and formatting changes, made some changes to the section discussing dialogs.

* Update articles/bot-service-design-conversation-flow.md

Co-authored-by: Jonathan Fingold <[email protected]>

* Update articles/bot-service-design-conversation-flow.md

Co-authored-by: Jonathan Fingold <[email protected]>

* Update articles/bot-service-design-conversation-flow.md

Co-authored-by: Jonathan Fingold <[email protected]>

* Update articles/bot-service-design-conversation-flow.md

Co-authored-by: Jonathan Fingold <[email protected]>

* Update articles/bot-service-design-conversation-flow.md

Co-authored-by: Jonathan Fingold <[email protected]>

* Update bot-service-design-conversation-flow.md

* Update bot-service-design-conversation-flow.md

Co-authored-by: Jonathan Fingold <[email protected]>
  • Loading branch information
WashingtonKayaker and JonathanFingold authored Jan 11, 2021
commit 3e20411e97e0e3f2f999d403a87210114e65276d
47 changes: 23 additions & 24 deletions articles/bot-service-design-conversation-flow.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,41 +17,41 @@ ms.date: 11/19/2019
In a traditional application, the user interface (UI) consists of a series of screens, and a single app or website can use one or more screens as needed to exchange information with the user.
Most applications start with a main screen where users initially land, and that screen provides navigation that leads to other screens for various functions like starting a new order, browsing products, or looking for help.

Like apps and websites, bots have a UI, but it is made up of **messages** rather than screens. Messages may contain buttons, text, and other elements, or be entirely speech-based.
Like apps and websites, bots have a UI, but it is made up of _messages_ rather than screens. Messages may contain buttons, text, and other elements, or be entirely speech-based.

While a traditional application or website can request multiple pieces of information on a screen all at once, a bot will gather the same amount of information using multiple messages. In this way, the process of gathering information from the user is an active experience; one where the user is having an active conversation with the bot.

A well designed bot will have a conversation flow that feels natural. The bot should be able to handle the core conversation seamlessly, and be able to handle interruptions or switching topic of conversations gracefully.
A well-designed bot will have a conversational flow that feels natural. The bot should be able to handle the core conversation seamlessly and be able to handle interruptions or switching topics gracefully.

## Procedural conversation flow

Conversation with a bot is generally focused around the task a bot is trying to achieve, which is called a procedural flow. This is where the bot asks the user a series of questions to gather all the information it needs before processing the task.
Conversations with a bot are generally focused on the task a bot is trying to achieve, which is called a procedural flow. This is where the bot asks the user a series of questions to gather all the information it needs before processing the task.

In a procedural conversation flow, you define the order of the questions and the bot will ask the questions in the order you defined. You can organize the questions into logical *modules* to keep the code centralized while staying focused on guiding the conversational. For example, you may design one module to contain the logic that helps the user browse for products and a separate module to contain the logic that helps the user create a new order.
In a procedural conversation flow, you define the order of the questions and the bot will ask the questions in the order you defined. You can organize the questions into logical groups to keep the code centralized while staying focused on guiding the conversation. For example, you may design one module to contain the logic that helps the user browse for products and a separate module to contain the logic that helps the user create a new order.

You can structure these modules to flow in any way you like, ranging from free form to sequential. The Bot Framework SDK provides several libraries that allows you to construct any conversational flow your bot needs. For example, the `prompts` library allows you to ask users for input, the `waterfall` library allows you to define a sequence of question/answer pair, the `dialog control` library allows you to modularized your conversational flow logic, etc. All of these libraries are tied together through a `dialogs` object. Let's take a closer look at how modules are implemented as `dialogs` to design and manage conversation flows and see how that flow is similar to the traditional application flow.
You can structure these modules to flow in any way you like, ranging from free form to sequential. The Bot Framework SDK provides a dialogs library that allows you to construct any conversational flow your bot needs. The library includes [waterfall dialogs](/azure/bot-service/bot-builder-concept-waterfall-dialogs) for creating a sequence of steps and prompts for asking users questions. For more information, see [Dialogs library](/azure/bot-service/bot-builder-concept-dialog).

![Application GUI flow compared to bot conversation flow](./media/designing-bots/core/dialogs-screens.png)

In a traditional application, everything begins with the **main screen**.
The **main screen** invokes the **new order screen**.
The **new order screen** remains in control until it either closes or invokes other screens, such as the **product search screen**.
If the **new order screen** closes, the user is returned to the **main screen**.
In a traditional application, everything begins with the _main_ screen.
The main screen invokes the _new order_ screen.
The new order screen remains in control until it either closes or invokes other screens, such as the _product search_ screen.
If the new order screen closes, the user is returned to the main screen.

In a bot, everything begins with the **root dialog**.
The **root dialog** invokes the **new order dialog**.
At that point, the **new order dialog** takes control of the conversation and remains in control until it either closes or invokes other dialogs, such as the **product search dialog**.
If the **new order dialog** closes, control of the conversation is returned back to the **root dialog**.
In a bot that uses dialogs, everything begins with the _root dialog_.
The root dialog invokes the _new order dialog_.
At that point, the new order dialog takes control of the conversation and remains in control until it either closes or invokes another dialog, such as the _product search dialog_.
If the new order dialog closes, control of the conversation returns back to the root dialog.

For examples of how implement conversation flow, see how to [create your own prompts to gather user input](./v4sdk/bot-builder-primitive-prompts.md) and use dialogs to [implement sequential conversation flow](./v4sdk/bot-builder-dialog-manage-conversation-flow.md).
For an example of how to implement a conversational flow using the dialog libraries, see [Implement sequential conversation flow](./v4sdk/bot-builder-dialog-manage-conversation-flow.md).

## Handle interruptions

It may be tempting to assume that users will perform procedural tasks one by one in a neat and orderly way.
For example, in a procedural conversation flow using `dialogs`, the user will start at root dialog, invoke the new order dialog from there, and then invoke the product search dialog. Then the user will select a product and confirm, exiting the product search dialog, complete the order, exiting the new order dialog, and arrive back at the root dialog.
For example, in a procedural conversation flow using dialogs, the user will start at the root dialog and invoke the new order dialog. From the new order dialog, they invoke the product search dialog. Then when selecting one of the results listed in product search dialog, they invoke the new order dialog. After completing the order, they arrive back at the root dialog.

Although it would be great if users always traveled such a linear, logical path, it seldom occurs.
Humans do not communicate in sequential `dialogs`. They tend to frequently change their minds.
People do not always communicate in sequential order. They tend to frequently change their minds.
Consider the following example:

![User asks a question in response to a question from the bot](./media/bot-service-design-conversation-flow/stack-issue.png)
Expand All @@ -64,24 +64,23 @@ How should your bot respond?
- Disregard everything that the user had done previously, reset the whole dialog stack, and start from the beginning by attempting to answer the user's question.
- Attempt to answer the user's question and then return to that yes/no question and try to resume from there.

There is no *right* answer to this question, as the best solution will depend upon the specifics of your scenario and how the user would reasonably expect the bot to respond. For more information see [Handle user interruption](v4sdk/bot-builder-howto-handle-user-interrupt.md).
There is no *right* answer to this question, as the best solution will depend upon the specifics of your scenario and how the user would reasonably expect the bot to respond. See how to [Handle user interruptions](v4sdk/bot-builder-howto-handle-user-interrupt.md) for a bot that is designed to handle some types of interruptions.

## Expire a conversation

There are times when it is useful to restart a conversation from the beginning. For instance, if a user does not respond after a certain period of time. Different methods for expiring a conversation include:
There are times when it is useful to restart a conversation from the beginning. For instance, if a user does not respond after a certain period of time. Different methods for ending a conversation include:

- Track the last time a message was received from a user, and clear state if the time is greater than a preconfigured length upon receiving the next message from the user.
- Use a storage layer feature, such as CosmosDb Time To Live, to clear state after a preconfigured length of time.
- Use a storage layer feature, such as Cosmos DB's [time-to-live](/azure/cosmos-db/how-to-time-to-live) feature, to clear state after a preconfigured length of time.

<!--
NOTE: in the future, provide guidance on an azure function queue or time trigger

- Track the last time a message was received from a user, and run a Web Job or Azure Function to clear the state and/or proactively message the user.
-->

For more information see [How To: Expire a conversation](v4sdk/bot-builder-howto-expire-conversation.md)
For more information see how to [Expire a conversation](v4sdk/bot-builder-howto-expire-conversation.md).

## Next steps

Managing the user's navigation across dialogs and designing conversation flow in a manner that enables
users to achieve their goals (even in a non-linear fashion) is a fundamental challenge of bot design.
The [next article](~/bot-service-design-navigation.md) reviews some common pitfalls of poorly designed navigation and discusses strategies for avoiding those traps.
Managing the user's navigation across dialogs and designing a conversational flow in a manner that enables users to achieve their goals (even in a non-linear fashion) is a fundamental challenge of bot design.
The [Design bot navigation](bot-service-design-navigation.md) article reviews some common pitfalls of poorly designed navigation and discusses strategies for avoiding those traps.